{
  "openapi": "3.1.0",
  "info": {
    "title": "Agent Service Market",
    "version": "0.29.0",
    "description": "Static 0.29.0 release reference. Build-time release reference. Runtime readiness, deployment, payment settlement and external indexing are not evaluated here. Prices are proposed; this file cannot authorize execution or payment. API location is separately configured. No paid MCP execution."
  },
  "paths": {
    "/v1/x402/json-canonicalize": {
      "post": {
        "operationId": "x402_json_canonicalize",
        "summary": "Deterministic JSON serialization",
        "description": "WHEN TO USE: Normalize JSON for cache keys or repeatable diffs. Recursively sorts object keys, preserves array order, and emits compact JSON plus UTF-8 byte length. Uses JavaScript numbers and JSON.stringify: integer-index keys serialize numerically before other sorted keys; large integers may already have lost precision. This is not RFC 8785 cryptographic canonicalization. Maximum 100,000 serialized characters, 1,000 entries per collection, depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-canonicalize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "stable JSON cache key",
            "normalize JSON key order"
          ],
          "whenToUse": [
            "Sort JSON object keys for reproducible serialization."
          ],
          "whenNotToUse": [
            "Cryptographic RFC 8785 canonicalization or lossless arbitrary-precision numbers."
          ],
          "capabilities": [
            "json-canonicalize",
            "stable JSON cache key",
            "normalize JSON key order"
          ],
          "related": [
            "content-digest",
            "lines-diff"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "value": {
                    "$ref": "#/paths/~1v1~1x402~1json-canonicalize/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "value"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-canonicalize/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-canonicalize/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "value": {
                  "customer": "Ada",
                  "active": true,
                  "settings": {
                    "theme": "dark",
                    "locale": "en"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-canonicalize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "canonical": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "bytesUtf8": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "canonical",
                        "bytesUtf8"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-canonicalize",
                  "version": "0.29.0",
                  "result": {
                    "canonical": "{\"active\":true,\"customer\":\"Ada\",\"settings\":{\"locale\":\"en\",\"theme\":\"dark\"}}",
                    "bytesUtf8": 74
                  },
                  "provenance": {
                    "inputSha256": "55026756992759c1270a9bf20c3734d5bb5e83e17bc2b1ad8af8455ecdb88498",
                    "outputSha256": "503d0b2c39cea4d203d24a39423288afa4f9b906eab37f7f1a4fa7898e2a661b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-pointer": {
      "post": {
        "operationId": "x402_json_pointer",
        "summary": "JSON Pointer resolution",
        "description": "WHEN TO USE: Extract one precisely addressed value from an API payload without a query language. Resolves RFC 6901 string pointers, including ~0 and ~1 escaping and the empty root pointer. Missing members, URI fragments, leading-zero array indexes, and reserved prototype-related keys are errors. Maximum document size 100,000 characters and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-pointer.md"
        },
        "x-agent-discovery": {
          "intents": [
            "extract nested JSON field by exact path",
            "pick one value from an object or array response",
            "resolve RFC 6901 pointer"
          ],
          "whenToUse": [
            "Read one value at an exact JSON Pointer."
          ],
          "whenNotToUse": [
            "JSONPath queries, wildcard selection, or remote API fetching."
          ],
          "capabilities": [
            "json-pointer",
            "extract nested JSON field by exact path",
            "pick one value from an object or array response",
            "resolve RFC 6901 pointer"
          ],
          "related": [
            "records-project",
            "json-flatten"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1x402~1json-pointer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "pointer": {
                    "type": "string",
                    "maxLength": 2048,
                    "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                  }
                },
                "required": [
                  "document",
                  "pointer"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-pointer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-pointer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "orders": [
                    {
                      "id": "ord_17",
                      "total": 49.5
                    }
                  ]
                },
                "pointer": "/orders/0/id"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-pointer",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "pointer": {
                          "type": "string",
                          "maxLength": 2048,
                          "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                        },
                        "value": {
                          "$ref": "#/paths/~1v1~1x402~1json-pointer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        }
                      },
                      "required": [
                        "pointer",
                        "value"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-pointer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-pointer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-pointer",
                  "version": "0.29.0",
                  "result": {
                    "pointer": "/orders/0/id",
                    "value": "ord_17"
                  },
                  "provenance": {
                    "inputSha256": "06368e36f2e4a16c20eb00da9e6ac1c047c4561c8533d474d596fabd182de609",
                    "outputSha256": "09f8ce26cf2105810f77b709eb56b426a313e435d40f609062e40e2b12ec5483",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-patch": {
      "post": {
        "operationId": "x402_json_patch",
        "summary": "Atomic JSON Patch",
        "description": "WHEN TO USE: Apply a bounded update plan atomically before saving an API document. Implements RFC 6902 add, remove, replace, move, copy, and structural test on a private clone; stops on the first error. Strict operation schemas reject extra fields. Up to 100 operations; size, depth, and 1,000-item limits checked after each operation. Removing the root returns documentExists=false and document=null; adding the root restores it. Reserved prototype-related paths are rejected.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-patch.md"
        },
        "x-agent-discovery": {
          "intents": [
            "apply RFC 6902 patch",
            "ordered property changes with value assertions",
            "atomic JSON document update"
          ],
          "whenToUse": [
            "Apply an explicit add/remove/replace/move/copy/test plan to supplied JSON."
          ],
          "whenNotToUse": [
            "Generating a patch from prose or writing to a remote system."
          ],
          "capabilities": [
            "json-patch",
            "apply RFC 6902 patch",
            "ordered property changes with value assertions",
            "atomic JSON document update"
          ],
          "related": [
            "json-merge-patch",
            "json-schema-check"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1x402~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "operations": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "add"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "value": {
                              "$ref": "#/paths/~1v1~1x402~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          },
                          "required": [
                            "op",
                            "path",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "replace"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "value": {
                              "$ref": "#/paths/~1v1~1x402~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          },
                          "required": [
                            "op",
                            "path",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "test"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "value": {
                              "$ref": "#/paths/~1v1~1x402~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          },
                          "required": [
                            "op",
                            "path",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "remove"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            }
                          },
                          "required": [
                            "op",
                            "path"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "move"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "from": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            }
                          },
                          "required": [
                            "op",
                            "path",
                            "from"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "copy"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "from": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            }
                          },
                          "required": [
                            "op",
                            "path",
                            "from"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "document",
                  "operations"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "status": "draft",
                  "tags": [
                    "new"
                  ]
                },
                "operations": [
                  {
                    "op": "test",
                    "path": "/status",
                    "value": "draft"
                  },
                  {
                    "op": "replace",
                    "path": "/status",
                    "value": "ready"
                  },
                  {
                    "op": "add",
                    "path": "/tags/-",
                    "value": "reviewed"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-patch",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "document": {
                          "$ref": "#/paths/~1v1~1x402~1json-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        },
                        "documentExists": {
                          "type": "boolean"
                        },
                        "appliedOperations": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "document",
                        "documentExists",
                        "appliedOperations"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-patch",
                  "version": "0.29.0",
                  "result": {
                    "document": {
                      "status": "ready",
                      "tags": [
                        "new",
                        "reviewed"
                      ]
                    },
                    "documentExists": true,
                    "appliedOperations": 3
                  },
                  "provenance": {
                    "inputSha256": "86cdf2df89d9a45405b30cbcd8fa9bf56893fe5adecd2727fda0afc3088ac15c",
                    "outputSha256": "2b59e51b84b627f0de07f1356e62caeb7d5d6c813c9813add695503ea058a568",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-merge-patch": {
      "post": {
        "operationId": "x402_json_merge_patch",
        "summary": "JSON Merge Patch",
        "description": "WHEN TO USE: Apply simple partial-object updates using RFC 7396. Object members recursively merge, null members delete, arrays replace wholesale, and non-object patches replace the entire target. The target is never mutated. Maximum 100,000 serialized characters, 1,000 entries per collection, depth 32; reserved prototype-related keys are rejected.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-merge-patch.md"
        },
        "x-agent-discovery": {
          "intents": [
            "partial JSON object update",
            "apply RFC 7396 merge patch"
          ],
          "whenToUse": [
            "Merge partial objects, with null deleting members and arrays replacing wholesale."
          ],
          "whenNotToUse": [
            "Element-wise array merging or preserving explicit null object members."
          ],
          "capabilities": [
            "json-merge-patch",
            "partial JSON object update",
            "apply RFC 7396 merge patch"
          ],
          "related": [
            "json-patch"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "target": {
                    "$ref": "#/paths/~1v1~1x402~1json-merge-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "patch": {
                    "$ref": "#/paths/~1v1~1x402~1json-merge-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "target",
                  "patch"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-merge-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-merge-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "target": {
                  "name": "Ada",
                  "preferences": {
                    "theme": "light",
                    "language": "en"
                  },
                  "obsolete": true
                },
                "patch": {
                  "preferences": {
                    "theme": "dark"
                  },
                  "obsolete": null
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-merge-patch",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "document": {
                          "$ref": "#/paths/~1v1~1x402~1json-merge-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        }
                      },
                      "required": [
                        "document"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-merge-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-merge-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-merge-patch",
                  "version": "0.29.0",
                  "result": {
                    "document": {
                      "name": "Ada",
                      "preferences": {
                        "theme": "dark",
                        "language": "en"
                      }
                    }
                  },
                  "provenance": {
                    "inputSha256": "5e708cad77d8f9ada135e40e77b8b6a13770eb705090add5c6ea4979c50624da",
                    "outputSha256": "7b2fc4fbc15ed1600fdd36aa9e1082189347d9206aca39b296dc0835527e1b45",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-flatten": {
      "post": {
        "operationId": "x402_json_flatten",
        "summary": "Lossless JSON flattening",
        "description": "WHEN TO USE: Index nested payloads by escaped JSON Pointer for forms or change inspection. Returns scalar leaves in values and every object/array type in containers, preserving empty containers and numeric object keys for lossless unflattening. The root is represented by the empty pointer. Maximum 1,000 total pointers, output 100,000 characters, and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-flatten.md"
        },
        "x-agent-discovery": {
          "intents": [
            "flatten nested JSON to escaped paths and leaf values",
            "index JSON leaves and containers"
          ],
          "whenToUse": [
            "Produce escaped paths while preserving empty objects and arrays."
          ],
          "whenNotToUse": [
            "Flattening to ambiguous dotted keys or exceeding 1000 pointers."
          ],
          "capabilities": [
            "json-flatten",
            "flatten nested JSON to escaped paths and leaf values",
            "index JSON leaves and containers"
          ],
          "related": [
            "json-unflatten",
            "json-pointer"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1x402~1json-flatten/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "document"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-flatten/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-flatten/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "customer": {
                    "name": "Ada"
                  },
                  "tags": [
                    "priority"
                  ],
                  "metadata": {}
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-flatten",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "values": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "maxLength": 2048,
                            "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                          },
                          "additionalProperties": {
                            "type": [
                              "string",
                              "number",
                              "boolean",
                              "null"
                            ]
                          }
                        },
                        "containers": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "maxLength": 2048,
                            "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                          },
                          "additionalProperties": {
                            "type": "string",
                            "enum": [
                              "object",
                              "array"
                            ]
                          }
                        },
                        "pointerCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "values",
                        "containers",
                        "pointerCount"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-flatten",
                  "version": "0.29.0",
                  "result": {
                    "values": {
                      "/customer/name": "Ada",
                      "/tags/0": "priority"
                    },
                    "containers": {
                      "": "object",
                      "/customer": "object",
                      "/tags": "array",
                      "/metadata": "object"
                    },
                    "pointerCount": 6
                  },
                  "provenance": {
                    "inputSha256": "495fc5c3012962fff807a29755798a6c1817291653fce5ab95b3a0ed729456b5",
                    "outputSha256": "4279f9640f858c0dde980d284e7bd1b14b915e868cf678b5812888d05b60ad05",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-unflatten": {
      "post": {
        "operationId": "x402_json_unflatten",
        "summary": "Lossless JSON reconstruction",
        "description": "WHEN TO USE: Rebuild JSON from json-flatten output without guessing whether numeric keys belong to arrays or objects. Supply scalar values and explicit container types, including the empty root pointer. Rejects leaf/container collisions, missing parents, sparse arrays, unsafe keys, and malformed pointers. Maximum 1,000 combined pointers, 100,000 characters, depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-unflatten.md"
        },
        "x-agent-discovery": {
          "intents": [
            "reconstruct nested JSON from leaf paths",
            "restore flattened JSON preserving empty arrays and objects"
          ],
          "whenToUse": [
            "Rebuild a document from explicit scalar leaves and container kinds."
          ],
          "whenNotToUse": [
            "Guessing missing parent types or accepting sparse arrays."
          ],
          "capabilities": [
            "json-unflatten",
            "reconstruct nested JSON from leaf paths",
            "restore flattened JSON preserving empty arrays and objects"
          ],
          "related": [
            "json-flatten"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "values": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "maxLength": 2048,
                      "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                    },
                    "additionalProperties": {
                      "type": [
                        "string",
                        "number",
                        "boolean",
                        "null"
                      ]
                    }
                  },
                  "containers": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "maxLength": 2048,
                      "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                    },
                    "additionalProperties": {
                      "type": "string",
                      "enum": [
                        "object",
                        "array"
                      ]
                    }
                  }
                },
                "required": [
                  "values",
                  "containers"
                ],
                "additionalProperties": false
              },
              "example": {
                "values": {
                  "/customer/name": "Ada",
                  "/tags/0": "priority"
                },
                "containers": {
                  "": "object",
                  "/customer": "object",
                  "/tags": "array",
                  "/metadata": "object"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-unflatten",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "document": {
                          "$ref": "#/paths/~1v1~1x402~1json-unflatten/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        },
                        "pointerCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "document",
                        "pointerCount"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-unflatten/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-unflatten/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-unflatten",
                  "version": "0.29.0",
                  "result": {
                    "document": {
                      "customer": {
                        "name": "Ada"
                      },
                      "tags": [
                        "priority"
                      ],
                      "metadata": {}
                    },
                    "pointerCount": 6
                  },
                  "provenance": {
                    "inputSha256": "51d1c2ecc468fe2a5eba7e867dea2c7629b5a2164a259d319361e7e79d3cf0d6",
                    "outputSha256": "6be9d6ede6c4bc809b96f86e2f3c076cda6fff9e8bd9e98dc61cd4aa16fecc0f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/records-project": {
      "post": {
        "operationId": "x402_records_project",
        "summary": "Record field projection",
        "description": "WHEN TO USE: Shape up to 1,000 records into a small downstream payload, selecting nested fields with JSON Pointers and assigning flat output names. Up to 100 unique output names; missing fields are omitted, set to null, or rejected according to onMissing (default error). Unsafe names are rejected. Maximum 100,000 serialized characters and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-project.md"
        },
        "x-agent-discovery": {
          "intents": [
            "select and rename fields from each row",
            "keep only chosen nested record properties",
            "reshape API records"
          ],
          "whenToUse": [
            "Select JSON Pointer fields from each record and rename them to flat output names."
          ],
          "whenNotToUse": [
            "Computed expressions, joins, or arbitrary query languages."
          ],
          "capabilities": [
            "records-project",
            "select and rename fields from each row",
            "keep only chosen nested record properties",
            "reshape API records"
          ],
          "related": [
            "records-filter",
            "csv-serialize"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1records-project/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "fields": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "from": {
                          "type": "string",
                          "maxLength": 2048,
                          "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                        },
                        "as": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256
                        }
                      },
                      "required": [
                        "from",
                        "as"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "onMissing": {
                    "default": "error",
                    "type": "string",
                    "enum": [
                      "error",
                      "omit",
                      "null"
                    ]
                  }
                },
                "required": [
                  "records",
                  "fields"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1records-project/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1records-project/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "id": "c1",
                    "profile": {
                      "name": "Ada"
                    },
                    "internal": "omit"
                  }
                ],
                "fields": [
                  {
                    "from": "/id",
                    "as": "customerId"
                  },
                  {
                    "from": "/profile/name",
                    "as": "name"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-project",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "records": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "$ref": "#/paths/~1v1~1x402~1records-project/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            }
                          }
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "records",
                        "count"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1records-project/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1records-project/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-project",
                  "version": "0.29.0",
                  "result": {
                    "records": [
                      {
                        "customerId": "c1",
                        "name": "Ada"
                      }
                    ],
                    "count": 1
                  },
                  "provenance": {
                    "inputSha256": "f54239296a6b1d7b1df43cfe10b8bf920db595adf68d52fd99b00196202691e6",
                    "outputSha256": "51fece40e9e2c76141564e414db25d9d0b890474cfddbf97176681a58b5999b0",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/records-filter": {
      "post": {
        "operationId": "x402_records_filter",
        "summary": "Structured record filtering",
        "description": "WHEN TO USE: Select up to 1,000 records using 1–20 structured predicates with left-to-right short-circuit all/any logic, without executing code. All pointer syntax is validated before filtering. eq/ne use structural JSON equality; gt/gte/lt/lte compare same-type numbers or code-unit strings; contains tests substrings or structural array membership; in tests membership in a supplied list. Missing fields match only exists=false, including for ne. Returns original zero-based indexes. Maximum 100,000 characters and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-filter.md"
        },
        "x-agent-discovery": {
          "intents": [
            "filter records by predicates",
            "keep rows whose values match conditions",
            "select rows where amount exceeds threshold or status equals a value"
          ],
          "whenToUse": [
            "Apply structured all/any predicates without code execution."
          ],
          "whenNotToUse": [
            "Regular expressions, SQL, or fuzzy matching."
          ],
          "capabilities": [
            "records-filter",
            "filter records by predicates",
            "keep rows whose values match conditions",
            "select rows where amount exceeds threshold or status equals a value"
          ],
          "related": [
            "records-project",
            "records-sort"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1records-filter/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "mode": {
                    "default": "all",
                    "type": "string",
                    "enum": [
                      "all",
                      "any"
                    ]
                  },
                  "predicates": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "op": {
                              "type": "string",
                              "enum": [
                                "eq",
                                "ne",
                                "contains"
                              ]
                            },
                            "value": {
                              "$ref": "#/paths/~1v1~1x402~1records-filter/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          },
                          "required": [
                            "path",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "op": {
                              "type": "string",
                              "enum": [
                                "gt",
                                "gte",
                                "lt",
                                "lte"
                              ]
                            },
                            "value": {
                              "type": [
                                "string",
                                "number"
                              ]
                            }
                          },
                          "required": [
                            "path",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "op": {
                              "type": "string",
                              "const": "in"
                            },
                            "value": {
                              "maxItems": 100,
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1records-filter/post/requestBody/content/application~1json/schema/$defs/__schema0"
                              }
                            }
                          },
                          "required": [
                            "path",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "op": {
                              "type": "string",
                              "const": "exists"
                            },
                            "value": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "path",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "records",
                  "predicates"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1records-filter/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1records-filter/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "sku": "A",
                    "stock": 12
                  },
                  {
                    "sku": "B",
                    "stock": 0
                  }
                ],
                "predicates": [
                  {
                    "path": "/stock",
                    "op": "gt",
                    "value": 0
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-filter",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "records": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "$ref": "#/paths/~1v1~1x402~1records-filter/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            }
                          }
                        },
                        "indexes": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          }
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "records",
                        "indexes",
                        "count"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1records-filter/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1records-filter/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-filter",
                  "version": "0.29.0",
                  "result": {
                    "records": [
                      {
                        "sku": "A",
                        "stock": 12
                      }
                    ],
                    "indexes": [
                      0
                    ],
                    "count": 1
                  },
                  "provenance": {
                    "inputSha256": "6bbbee34c174f2434adc101913e2f3cdfa5fb686d20a165a6cbcb99d87bce52b",
                    "outputSha256": "72825d8085a06c7b895fa71e54c0aac20a228d159605daf9dd0df53f116f890b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/records-sort": {
      "post": {
        "operationId": "x402_records_sort",
        "summary": "Stable multi-key record sorting",
        "description": "WHEN TO USE: Order up to 1,000 records reproducibly using 1–10 nested JSON Pointer keys. Null and missing values tie and follow each key’s nulls setting independently of direction. Remaining ascending type order is boolean, number, string, array, object; booleans use false before true, strings use UTF-16 code units, arrays/objects compare deterministic JSON text. Equal keys preserve input order. Returns original indexes. Maximum 100,000 characters and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-sort.md"
        },
        "x-agent-discovery": {
          "intents": [
            "sort records by multiple fields",
            "stable JSON row ordering"
          ],
          "whenToUse": [
            "Order records by bounded nested keys with explicit null ordering."
          ],
          "whenNotToUse": [
            "Locale-aware collation or external database sorting."
          ],
          "capabilities": [
            "records-sort",
            "sort records by multiple fields",
            "stable JSON row ordering"
          ],
          "related": [
            "records-filter",
            "records-aggregate"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1records-sort/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "keys": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "maxLength": 2048,
                          "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                        },
                        "direction": {
                          "default": "asc",
                          "type": "string",
                          "enum": [
                            "asc",
                            "desc"
                          ]
                        },
                        "nulls": {
                          "default": "last",
                          "type": "string",
                          "enum": [
                            "first",
                            "last"
                          ]
                        }
                      },
                      "required": [
                        "path"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "records",
                  "keys"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1records-sort/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1records-sort/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "team": "sales",
                    "score": 8
                  },
                  {
                    "team": "sales",
                    "score": 10
                  },
                  {
                    "team": "support",
                    "score": 9
                  }
                ],
                "keys": [
                  {
                    "path": "/team"
                  },
                  {
                    "path": "/score",
                    "direction": "desc"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-sort",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "records": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "$ref": "#/paths/~1v1~1x402~1records-sort/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            }
                          }
                        },
                        "indexes": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          }
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "records",
                        "indexes",
                        "count"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1records-sort/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1records-sort/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-sort",
                  "version": "0.29.0",
                  "result": {
                    "records": [
                      {
                        "team": "sales",
                        "score": 10
                      },
                      {
                        "team": "sales",
                        "score": 8
                      },
                      {
                        "team": "support",
                        "score": 9
                      }
                    ],
                    "indexes": [
                      1,
                      0,
                      2
                    ],
                    "count": 3
                  },
                  "provenance": {
                    "inputSha256": "01b4f1978ec7ceca60d6e6696d86754d1c04b927f6b3a91ee2f8d03c4608a264",
                    "outputSha256": "34c945ba894ca0a225e9a6204478c8d26dc2e9a9ab6dd6653a46f16b52f645ab",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/records-aggregate": {
      "post": {
        "operationId": "x402_records_aggregate",
        "summary": "Grouped record aggregates",
        "description": "WHEN TO USE: Summarize up to 1,000 records with count/sum/avg/min/max, grouped by up to 5 JSON Pointer fields. Up to 20 uniquely named metrics. Group order follows first occurrence; missing keys are distinguished from null through a parallel missing array. Numeric metrics ignore missing/null, reject other non-numbers and overflow; empty sum/count are 0 and empty avg/min/max are null. No groupBy returns one global group, even for empty input. Maximum 100,000 characters and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-aggregate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "group records sum average count",
            "aggregate JSON metrics"
          ],
          "whenToUse": [
            "Calculate count/sum/avg/min/max over supplied bounded records."
          ],
          "whenNotToUse": [
            "Database queries, streaming analytics, or arbitrary formulas."
          ],
          "capabilities": [
            "records-aggregate",
            "group records sum average count",
            "aggregate JSON metrics"
          ],
          "related": [
            "records-filter",
            "records-project"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1records-aggregate/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "groupBy": {
                    "default": [],
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 2048,
                      "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                    }
                  },
                  "metrics": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "as": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256
                            },
                            "op": {
                              "type": "string",
                              "const": "count"
                            }
                          },
                          "required": [
                            "as",
                            "op"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "as": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256
                            },
                            "op": {
                              "type": "string",
                              "enum": [
                                "sum",
                                "avg",
                                "min",
                                "max"
                              ]
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            }
                          },
                          "required": [
                            "as",
                            "op",
                            "path"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "records",
                  "metrics"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1records-aggregate/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1records-aggregate/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "region": "west",
                    "revenue": 50
                  },
                  {
                    "region": "west",
                    "revenue": 70
                  },
                  {
                    "region": "east",
                    "revenue": 40
                  }
                ],
                "groupBy": [
                  "/region"
                ],
                "metrics": [
                  {
                    "as": "orders",
                    "op": "count"
                  },
                  {
                    "as": "revenue",
                    "op": "sum",
                    "path": "/revenue"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-aggregate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "groups": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "maxItems": 5,
                                "type": "array",
                                "items": {
                                  "$ref": "#/paths/~1v1~1x402~1records-aggregate/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                }
                              },
                              "missing": {
                                "maxItems": 5,
                                "type": "array",
                                "items": {
                                  "type": "boolean"
                                }
                              },
                              "count": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "metrics": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string"
                                },
                                "additionalProperties": {
                                  "type": [
                                    "number",
                                    "null"
                                  ]
                                }
                              }
                            },
                            "required": [
                              "key",
                              "missing",
                              "count",
                              "metrics"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "groupCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "recordCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "groups",
                        "groupCount",
                        "recordCount"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1records-aggregate/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1records-aggregate/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-aggregate",
                  "version": "0.29.0",
                  "result": {
                    "groups": [
                      {
                        "key": [
                          "west"
                        ],
                        "missing": [
                          false
                        ],
                        "count": 2,
                        "metrics": {
                          "orders": 2,
                          "revenue": 120
                        }
                      },
                      {
                        "key": [
                          "east"
                        ],
                        "missing": [
                          false
                        ],
                        "count": 1,
                        "metrics": {
                          "orders": 1,
                          "revenue": 40
                        }
                      }
                    ],
                    "groupCount": 2,
                    "recordCount": 3
                  },
                  "provenance": {
                    "inputSha256": "1924642abbb9dfc99b456bc9f2aa018f71096fa07cd1d5289e23237e3ca70b97",
                    "outputSha256": "092e95776a8a0b1c38162cc0100533a2e195b8d90f706500a5865e45ed0a24eb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/csv-parse": {
      "post": {
        "operationId": "x402_csv_parse",
        "summary": "Strict quoted CSV parser",
        "description": "WHEN TO USE: Convert a CSV export into string rows and optional header-keyed records. Handles RFC 4180 quoting, doubled quotes, embedded newlines, and CRLF; also accepts LF/CR line endings, one leading BOM, and optional semicolon/tab/pipe delimiters. Header mode defaults true and requires unique, nonempty, safe headers. Ragged rows and malformed quoting are errors. Values remain strings. Blank lines are one empty field; a final newline adds no row. Maximum 100,000 characters, 1,000 data rows, 100 columns.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/csv-parse.md"
        },
        "x-agent-discovery": {
          "intents": [
            "parse quoted CSV cells into JSON",
            "read comma delimited spreadsheet export with embedded newlines"
          ],
          "whenToUse": [
            "Parse bounded delimited text with strict quoting and rectangular rows."
          ],
          "whenNotToUse": [
            "Excel binary files, guessed value types, or malformed CSV repair."
          ],
          "capabilities": [
            "csv-parse",
            "parse quoted CSV cells into JSON",
            "read comma delimited spreadsheet export with embedded newlines"
          ],
          "related": [
            "csv-serialize",
            "records-project"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "delimiter": {
                    "default": ",",
                    "type": "string",
                    "enum": [
                      ",",
                      ";",
                      "\t",
                      "|"
                    ]
                  },
                  "header": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "name,city,note\r\nAda,London,\"likes tea, coffee\"\r\nLin,Taipei,\"said \"\"hello\"\"\"\r\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "csv-parse",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "headers": {
                          "anyOf": [
                            {
                              "maxItems": 100,
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "rows": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "records": {
                          "anyOf": [
                            {
                              "maxItems": 1000,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string"
                                },
                                "additionalProperties": {
                                  "type": "string"
                                }
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "rowCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "columnCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "headers",
                        "rows",
                        "records",
                        "rowCount",
                        "columnCount"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "csv-parse",
                  "version": "0.29.0",
                  "result": {
                    "headers": [
                      "name",
                      "city",
                      "note"
                    ],
                    "rows": [
                      [
                        "Ada",
                        "London",
                        "likes tea, coffee"
                      ],
                      [
                        "Lin",
                        "Taipei",
                        "said \"hello\""
                      ]
                    ],
                    "records": [
                      {
                        "name": "Ada",
                        "city": "London",
                        "note": "likes tea, coffee"
                      },
                      {
                        "name": "Lin",
                        "city": "Taipei",
                        "note": "said \"hello\""
                      }
                    ],
                    "rowCount": 2,
                    "columnCount": 3
                  },
                  "provenance": {
                    "inputSha256": "0b1b04d0728b29a45992b707f68c093fddd809329d42cc9303379e4605f428d9",
                    "outputSha256": "b24ca76e284c99db2096924ea8bbf42ff2beaa1b39143451cbd020199f6ace99",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/csv-serialize": {
      "post": {
        "operationId": "x402_csv_serialize",
        "summary": "Spreadsheet-safe CSV serializer",
        "description": "WHEN TO USE: Export scalar rows to CSV with RFC 4180 quoting and spreadsheet formula protection. By default, prefixes an apostrophe to string cells/headers beginning with =,+,-,@, their full-width variants, tab, CR, or LF (also after leading whitespace). Numeric values remain numeric; null becomes an empty cell. escapeFormulas=false is an explicit opt-out for trusted machine-only data; no escaping is universally safe after spreadsheet re-save. Optional unique headers; rectangular rows; CRLF and final newline by default. Maximum 1,000 rows, 100 columns, 100,000 output characters.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/csv-serialize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "export JSON rows as CSV",
            "escape spreadsheet formula cells"
          ],
          "whenToUse": [
            "Serialize scalar rows with default formula-trigger escaping."
          ],
          "whenNotToUse": [
            "A guarantee of safety after spreadsheet re-save or XLSX generation."
          ],
          "capabilities": [
            "csv-serialize",
            "export JSON rows as CSV",
            "escape spreadsheet formula cells"
          ],
          "related": [
            "csv-parse"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "rows": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": [
                          "string",
                          "number",
                          "boolean",
                          "null"
                        ]
                      }
                    }
                  },
                  "headers": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 2048
                    }
                  },
                  "delimiter": {
                    "default": ",",
                    "type": "string",
                    "enum": [
                      ",",
                      ";",
                      "\t",
                      "|"
                    ]
                  },
                  "newline": {
                    "default": "crlf",
                    "type": "string",
                    "enum": [
                      "crlf",
                      "lf"
                    ]
                  },
                  "finalNewline": {
                    "default": true,
                    "type": "boolean"
                  },
                  "escapeFormulas": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "rows"
                ],
                "additionalProperties": false
              },
              "example": {
                "headers": [
                  "customer",
                  "amount",
                  "comment"
                ],
                "rows": [
                  [
                    "Ada",
                    49.5,
                    "paid"
                  ],
                  [
                    "Lin",
                    20,
                    "=HYPERLINK(\"https://example.com\")"
                  ]
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "csv-serialize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "csv": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "rowCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "columnCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "escapedCells": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "csv",
                        "rowCount",
                        "columnCount",
                        "escapedCells"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "csv-serialize",
                  "version": "0.29.0",
                  "result": {
                    "csv": "customer,amount,comment\r\nAda,49.5,paid\r\nLin,20,\"'=HYPERLINK(\"\"https://example.com\"\")\"\r\n",
                    "rowCount": 2,
                    "columnCount": 3,
                    "escapedCells": 1
                  },
                  "provenance": {
                    "inputSha256": "3ac7682b1e2c885963261d2758d3a28f83e723047243636d594ae8ff781905b6",
                    "outputSha256": "1ebe7c7cde33757d848c02399325fab0eff66cdc158a9645d9bc8e9a66f5508a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/unicode-normalize": {
      "post": {
        "operationId": "x402_unicode_normalize",
        "summary": "Normalize Unicode",
        "description": "Use before comparing or indexing Unicode text. Applies exactly NFC, NFD, NFKC, or NFKD and reports UTF-16 lengths. Compatibility forms can change meaning; this is not transliteration, case folding, or confusable detection.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/unicode-normalize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "normalize Unicode NFC NFKC",
            "compare composed accented text"
          ],
          "whenToUse": [
            "Apply an explicit Unicode normalization form."
          ],
          "whenNotToUse": [
            "Transliteration, confusable detection, or case folding."
          ],
          "capabilities": [
            "unicode-normalize",
            "normalize Unicode NFC NFKC",
            "compare composed accented text"
          ],
          "related": [
            "whitespace-clean",
            "lines-dedupe"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "form": {
                    "default": "NFC",
                    "type": "string",
                    "enum": [
                      "NFC",
                      "NFD",
                      "NFKC",
                      "NFKD"
                    ]
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Café ①",
                "form": "NFKC"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "unicode-normalize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 1800000
                        },
                        "form": {
                          "type": "string",
                          "enum": [
                            "NFC",
                            "NFD",
                            "NFKC",
                            "NFKD"
                          ]
                        },
                        "changed": {
                          "type": "boolean"
                        },
                        "originalCodeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "normalizedCodeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1800000
                        }
                      },
                      "required": [
                        "text",
                        "form",
                        "changed",
                        "originalCodeUnits",
                        "normalizedCodeUnits"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "unicode-normalize",
                  "version": "0.29.0",
                  "result": {
                    "text": "Café 1",
                    "form": "NFKC",
                    "changed": true,
                    "originalCodeUnits": 7,
                    "normalizedCodeUnits": 6
                  },
                  "provenance": {
                    "inputSha256": "466d81292786e9dc2f185494fd308d3c03e3665b2c6126a7cd86c9926cd03a83",
                    "outputSha256": "874251a1cf210b12e2c1396cb1dc8fb0b8ef18991b5ece95099fa8654b500cb9",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/text-chunk": {
      "post": {
        "operationId": "x402_text_chunk",
        "summary": "Chunk text with overlap",
        "description": "Use to split a document into bounded Unicode-code-point windows with configurable overlap. Exact source slices use UTF-16 offsets, so adjacent windows can be verified without losing source characters. Not tokenization or grapheme segmentation. At most 2,000 chunks and 500,000 returned UTF-16 units.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-chunk.md"
        },
        "x-agent-discovery": {
          "intents": [
            "split document for RAG retrieval",
            "overlapping chunks with source offsets"
          ],
          "whenToUse": [
            "Create bounded code-point windows with verifiable UTF-16 source offsets."
          ],
          "whenNotToUse": [
            "Tokenizer-accurate token budgets or semantic passage segmentation."
          ],
          "capabilities": [
            "text-chunk",
            "split document for RAG retrieval",
            "overlapping chunks with source offsets"
          ],
          "related": [
            "markdown-outline",
            "html-to-text"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "maxChars": {
                    "default": 1000,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "overlapChars": {
                    "default": 0,
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9999
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Agents need exact source offsets for retrieval.",
                "maxChars": 20,
                "overlapChars": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-chunk",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        },
                        "originalCodeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "originalCodePoints": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "chunkCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2000
                        },
                        "chunks": {
                          "maxItems": 2000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1999
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "codePoints": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 10000
                              },
                              "text": {
                                "type": "string",
                                "maxLength": 20000
                              }
                            },
                            "required": [
                              "index",
                              "start",
                              "end",
                              "codePoints",
                              "text"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "offsetUnit",
                        "originalCodeUnits",
                        "originalCodePoints",
                        "chunkCount",
                        "chunks"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-chunk",
                  "version": "0.29.0",
                  "result": {
                    "offsetUnit": "UTF-16 code units; zero-based, end-exclusive",
                    "originalCodeUnits": 47,
                    "originalCodePoints": 47,
                    "chunkCount": 3,
                    "chunks": [
                      {
                        "index": 0,
                        "start": 0,
                        "end": 20,
                        "codePoints": 20,
                        "text": "Agents need exact so"
                      },
                      {
                        "index": 1,
                        "start": 15,
                        "end": 35,
                        "codePoints": 20,
                        "text": "ct source offsets fo"
                      },
                      {
                        "index": 2,
                        "start": 30,
                        "end": 47,
                        "codePoints": 17,
                        "text": "ts for retrieval."
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "fbd009549808504641990274a3acdffd9280cad74caa8c7614b5cea66a9be5f1",
                    "outputSha256": "7b3184db21762bfcd8b96cd0555cb3af852650c154c8d79c1145d6d37d48dd2a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/text-metrics": {
      "post": {
        "operationId": "x402_text_metrics",
        "summary": "Measure text",
        "description": "Use for deterministic document sizing and basic QA. Counts UTF-16 units, Unicode code points, UTF-8 bytes, whitespace, logical lines, blank-line-separated paragraphs, and word-like spans. Words use Unicode letters/numbers with internal apostrophes; this is not linguistic segmentation, token counting, or a readability score. Empty text has zero lines; a final newline adds an empty line.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-metrics.md"
        },
        "x-agent-discovery": {
          "intents": [
            "count characters bytes words lines",
            "measure document size"
          ],
          "whenToUse": [
            "Measure deterministic Unicode and byte sizes with basic word-like counts."
          ],
          "whenNotToUse": [
            "Model token counts, language-specific segmentation, or readability scoring."
          ],
          "capabilities": [
            "text-metrics",
            "count characters bytes words lines",
            "measure document size"
          ],
          "related": [
            "text-chunk"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "One small agent.\n\nTwo useful tools.\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-metrics",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "codeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "codePoints": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "utf8Bytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 400000
                        },
                        "whitespaceCodePoints": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "lines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "blankLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "nonBlankLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "paragraphs": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "wordLikeSpans": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "uniqueWordsCaseInsensitive": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        }
                      },
                      "required": [
                        "codeUnits",
                        "codePoints",
                        "utf8Bytes",
                        "whitespaceCodePoints",
                        "lines",
                        "blankLines",
                        "nonBlankLines",
                        "paragraphs",
                        "wordLikeSpans",
                        "uniqueWordsCaseInsensitive"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-metrics",
                  "version": "0.29.0",
                  "result": {
                    "codeUnits": 36,
                    "codePoints": 36,
                    "utf8Bytes": 36,
                    "whitespaceCodePoints": 7,
                    "lines": 4,
                    "blankLines": 2,
                    "nonBlankLines": 2,
                    "paragraphs": 2,
                    "wordLikeSpans": 6,
                    "uniqueWordsCaseInsensitive": 6
                  },
                  "provenance": {
                    "inputSha256": "614a32ac9b8d044ded2e68304252726549b5622023f0f761daaf9e0a8611ca52",
                    "outputSha256": "830d68c6a57c0493f768b277785145a404ea7b00f3df80bbd9d1cda47217659c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/lines-dedupe": {
      "post": {
        "operationId": "x402_lines_dedupe",
        "summary": "Deduplicate lines",
        "description": "Use to remove repeated records from newline-delimited text while keeping the first original spelling and order. Comparison optionally trims whitespace and uses locale-independent lowercase. Output separators become LF; no fuzzy matching or Unicode normalization. Empty text has zero lines; a trailing newline represents a final blank line.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/lines-dedupe.md"
        },
        "x-agent-discovery": {
          "intents": [
            "remove duplicate text lines",
            "deduplicate newline records"
          ],
          "whenToUse": [
            "Keep the first spelling and order with optional trim/lowercase comparison."
          ],
          "whenNotToUse": [
            "Fuzzy entity resolution or Unicode normalization."
          ],
          "capabilities": [
            "lines-dedupe",
            "remove duplicate text lines",
            "deduplicate newline records"
          ],
          "related": [
            "unicode-normalize",
            "whitespace-clean"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "trimForComparison": {
                    "default": false,
                    "type": "boolean"
                  },
                  "caseSensitive": {
                    "default": true,
                    "type": "boolean"
                  },
                  "dropEmpty": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Alpha\nBeta\n alpha \nBeta",
                "trimForComparison": true,
                "caseSensitive": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "lines-dedupe",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "inputLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "outputLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "duplicateLinesRemoved": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "emptyLinesRemoved": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "keptOriginalLineNumbers": {
                          "maxItems": 100001,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100001
                          }
                        }
                      },
                      "required": [
                        "text",
                        "inputLines",
                        "outputLines",
                        "duplicateLinesRemoved",
                        "emptyLinesRemoved",
                        "keptOriginalLineNumbers"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "lines-dedupe",
                  "version": "0.29.0",
                  "result": {
                    "text": "Alpha\nBeta",
                    "inputLines": 4,
                    "outputLines": 2,
                    "duplicateLinesRemoved": 2,
                    "emptyLinesRemoved": 0,
                    "keptOriginalLineNumbers": [
                      1,
                      2
                    ]
                  },
                  "provenance": {
                    "inputSha256": "c2483912e3f47691860b328a56b737710dd3ddfe2215cd13d62d858978378a9b",
                    "outputSha256": "0b13ea8b088f1220910f61475e1909bf90ca5a39f789eab1977ba255f1716b14",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/keywords-extract": {
      "post": {
        "operationId": "x402_keywords_extract",
        "summary": "Extract frequency keywords",
        "description": "Use to produce a small, reproducible frequency index for a document. Counts Unicode word-like spans containing letters, lowercases without stemming, optionally filters a fixed English stop list plus your stop words, and sorts by frequency then first occurrence. No semantic ranking, language detection, phrase extraction, or AI. First offsets refer to original UTF-16 text.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/keywords-extract.md"
        },
        "x-agent-discovery": {
          "intents": [
            "extract frequent words",
            "rank document content words by frequency excluding common stopwords",
            "frequency keyword index"
          ],
          "whenToUse": [
            "Count word-like spans with optional stopword filtering."
          ],
          "whenNotToUse": [
            "Semantic keywords, sentiment, topic modeling, or language detection."
          ],
          "capabilities": [
            "keywords-extract",
            "extract frequent words",
            "rank document content words by frequency excluding common stopwords",
            "frequency keyword index"
          ],
          "related": [
            "text-metrics"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "limit": {
                    "default": 20,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "minLength": {
                    "default": 3,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 50
                  },
                  "useEnglishStopWords": {
                    "default": true,
                    "type": "boolean"
                  },
                  "stopWords": {
                    "default": [],
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Agents call tools. Reliable tools help agents. Agents need reliable APIs.",
                "limit": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "keywords-extract",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        },
                        "totalCandidates": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "uniqueCandidates": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "keywords": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "keyword": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 200000
                              },
                              "count": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100000
                              },
                              "firstOffset": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              }
                            },
                            "required": [
                              "keyword",
                              "count",
                              "firstOffset"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "offsetUnit",
                        "totalCandidates",
                        "uniqueCandidates",
                        "keywords"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "keywords-extract",
                  "version": "0.29.0",
                  "result": {
                    "offsetUnit": "UTF-16 code units; zero-based, end-exclusive",
                    "totalCandidates": 11,
                    "uniqueCandidates": 7,
                    "keywords": [
                      {
                        "keyword": "agents",
                        "count": 3,
                        "firstOffset": 0
                      },
                      {
                        "keyword": "tools",
                        "count": 2,
                        "firstOffset": 12
                      },
                      {
                        "keyword": "reliable",
                        "count": 2,
                        "firstOffset": 19
                      },
                      {
                        "keyword": "call",
                        "count": 1,
                        "firstOffset": 7
                      },
                      {
                        "keyword": "help",
                        "count": 1,
                        "firstOffset": 34
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "e1093d85e7862788bef58f9027d758d036bcc705d5118f97af758a40bb8675b7",
                    "outputSha256": "b6b220e1827e739ce3d78dd6b3978b76181d974a5e166c9f331843b591d5e677",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/lines-diff": {
      "post": {
        "operationId": "x402_lines_diff",
        "summary": "Diff bounded line sequences",
        "description": "Use for auditable changes between small documents. Computes a minimal insertion/deletion script by bounded longest-common-subsequence, with one-based old/new line numbers; ties delete first. Maximum 300 lines and 30,000 UTF-16 units per document. Compares line content exactly but ignores CR/LF separator style; a final newline is an additional empty line. Not a byte diff, patch file, or fuzzy diff.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/lines-diff.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compare two text versions for added and removed lines",
            "minimal line insertion deletion diff"
          ],
          "whenToUse": [
            "Inspect exact bounded line changes with source line numbers."
          ],
          "whenNotToUse": [
            "Large files, fuzzy matching, byte comparison, or executable patch output."
          ],
          "capabilities": [
            "lines-diff",
            "compare two text versions for added and removed lines",
            "minimal line insertion deletion diff"
          ],
          "related": [
            "whitespace-clean"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "before": {
                    "type": "string",
                    "maxLength": 30000
                  },
                  "after": {
                    "type": "string",
                    "maxLength": 30000
                  }
                },
                "required": [
                  "before",
                  "after"
                ],
                "additionalProperties": false
              },
              "example": {
                "before": "status: pending\nowner: agent",
                "after": "status: ready\nowner: agent\nverified: yes"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "lines-diff",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "equal": {
                          "type": "boolean"
                        },
                        "beforeLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 300
                        },
                        "afterLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 300
                        },
                        "inserted": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 300
                        },
                        "deleted": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 300
                        },
                        "unchanged": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 300
                        },
                        "operations": {
                          "maxItems": 600,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "equal",
                                  "delete",
                                  "insert"
                                ]
                              },
                              "text": {
                                "type": "string",
                                "maxLength": 30000
                              },
                              "oldLine": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 300
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "newLine": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 300
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "kind",
                              "text",
                              "oldLine",
                              "newLine"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "equal",
                        "beforeLines",
                        "afterLines",
                        "inserted",
                        "deleted",
                        "unchanged",
                        "operations"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "lines-diff",
                  "version": "0.29.0",
                  "result": {
                    "equal": false,
                    "beforeLines": 2,
                    "afterLines": 3,
                    "inserted": 2,
                    "deleted": 1,
                    "unchanged": 1,
                    "operations": [
                      {
                        "kind": "delete",
                        "text": "status: pending",
                        "oldLine": 1,
                        "newLine": null
                      },
                      {
                        "kind": "insert",
                        "text": "status: ready",
                        "oldLine": null,
                        "newLine": 1
                      },
                      {
                        "kind": "equal",
                        "text": "owner: agent",
                        "oldLine": 2,
                        "newLine": 2
                      },
                      {
                        "kind": "insert",
                        "text": "verified: yes",
                        "oldLine": null,
                        "newLine": 3
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "068d2614e67a7711f69ba149a0078057a3d513739d4cd29472e862844c79cf7e",
                    "outputSha256": "12f9ddb453a70083094c4adc8a8fa2a5961c67eb609a6f53a7db12c8d8d35d24",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/markdown-outline": {
      "post": {
        "operationId": "x402_markdown_outline",
        "summary": "Outline Markdown headings",
        "description": "Use to build a lightweight navigation index or section slicer. Finds ATX headings (# through ######) with up to three leading spaces, ignores fenced code, and supplies parent indexes and exact section offsets. Heading text remains inline Markdown. Does not parse Setext headings, indented code, block quotes, HTML blocks, or a full CommonMark AST. At most 5,000 headings.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/markdown-outline.md"
        },
        "x-agent-discovery": {
          "intents": [
            "extract Markdown headings",
            "document section outline"
          ],
          "whenToUse": [
            "Find supported ATX headings and exact section offsets."
          ],
          "whenNotToUse": [
            "A complete CommonMark AST or Setext/HTML heading support."
          ],
          "capabilities": [
            "markdown-outline",
            "extract Markdown headings",
            "document section outline"
          ],
          "related": [
            "markdown-links",
            "text-chunk"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string",
                    "maxLength": 100000
                  }
                },
                "required": [
                  "markdown"
                ],
                "additionalProperties": false
              },
              "example": {
                "markdown": "# Guide\nIntroduction\n## Install\nRun setup.\n## Usage\nCall the API."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "markdown-outline",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        },
                        "headings": {
                          "maxItems": 5000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 4999
                              },
                              "level": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 6
                              },
                              "title": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "line": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100001
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "headingEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "sectionEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "parentIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 4999
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "index",
                              "level",
                              "title",
                              "line",
                              "start",
                              "headingEnd",
                              "sectionEnd",
                              "parentIndex"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 5000
                        }
                      },
                      "required": [
                        "offsetUnit",
                        "headings",
                        "count"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "markdown-outline",
                  "version": "0.29.0",
                  "result": {
                    "offsetUnit": "UTF-16 code units; zero-based, end-exclusive",
                    "headings": [
                      {
                        "index": 0,
                        "level": 1,
                        "title": "Guide",
                        "line": 1,
                        "start": 0,
                        "headingEnd": 7,
                        "sectionEnd": 65,
                        "parentIndex": null
                      },
                      {
                        "index": 1,
                        "level": 2,
                        "title": "Install",
                        "line": 3,
                        "start": 21,
                        "headingEnd": 31,
                        "sectionEnd": 43,
                        "parentIndex": 0
                      },
                      {
                        "index": 2,
                        "level": 2,
                        "title": "Usage",
                        "line": 5,
                        "start": 43,
                        "headingEnd": 51,
                        "sectionEnd": 65,
                        "parentIndex": 0
                      }
                    ],
                    "count": 3
                  },
                  "provenance": {
                    "inputSha256": "1bc063ea69e10dab37ead6849f6d6084149d1e6775154229f1e5f4a1e8ad91cb",
                    "outputSha256": "ae2b47c73e4834f57c2305f128dd760962088584cdbfc9c140e5e175971b2dc3",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/markdown-links": {
      "post": {
        "operationId": "x402_markdown_links",
        "summary": "Extract Markdown links",
        "description": "Use to inventory explicit Markdown links without fetching them. Supports single-line inline links/images with non-nested labels, bare or angle-bracket destinations, balanced destination parentheses to depth 8, quoted titles, full/collapsed references with single-line definitions, and http(s) autolinks. Ignores fenced/inline code. No shortcut references, nested labels, HTML links, indented code, or full CommonMark parsing. URLs are untrusted, unvalidated strings; entities stay literal. Maximum 5,000 links, definitions, and unresolved references each.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/markdown-links.md"
        },
        "x-agent-discovery": {
          "intents": [
            "extract links from Markdown",
            "inventory reference links"
          ],
          "whenToUse": [
            "Collect supported explicit links and unresolved references without fetching."
          ],
          "whenNotToUse": [
            "Link availability checks, full CommonMark, or URL safety certification."
          ],
          "capabilities": [
            "markdown-links",
            "extract links from Markdown",
            "inventory reference links"
          ],
          "related": [
            "url-inspect",
            "markdown-outline"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string",
                    "maxLength": 100000
                  }
                },
                "required": [
                  "markdown"
                ],
                "additionalProperties": false
              },
              "example": {
                "markdown": "[API](https://example.com/api \"API docs\")\n[guide][g]\n\n[g]: https://example.com/guide"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "markdown-links",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        },
                        "links": {
                          "maxItems": 5000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "inline",
                                  "reference",
                                  "autolink"
                                ]
                              },
                              "image": {
                                "type": "boolean"
                              },
                              "label": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "title": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 100000
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "line": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100001
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              }
                            },
                            "required": [
                              "kind",
                              "image",
                              "label",
                              "url",
                              "title",
                              "line",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "definitions": {
                          "maxItems": 5000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "maxLength": 200000
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "title": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 100000
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "line": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100001
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              }
                            },
                            "required": [
                              "id",
                              "url",
                              "title",
                              "line",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "unresolvedReferences": {
                          "maxItems": 5000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "maxLength": 200000
                              },
                              "label": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "line": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100001
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              }
                            },
                            "required": [
                              "id",
                              "label",
                              "line",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "offsetUnit",
                        "links",
                        "definitions",
                        "unresolvedReferences"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "markdown-links",
                  "version": "0.29.0",
                  "result": {
                    "offsetUnit": "UTF-16 code units; zero-based, end-exclusive",
                    "links": [
                      {
                        "kind": "inline",
                        "image": false,
                        "label": "API",
                        "url": "https://example.com/api",
                        "title": "API docs",
                        "line": 1,
                        "start": 0,
                        "end": 41
                      },
                      {
                        "kind": "reference",
                        "image": false,
                        "label": "guide",
                        "url": "https://example.com/guide",
                        "title": null,
                        "line": 2,
                        "start": 42,
                        "end": 52
                      }
                    ],
                    "definitions": [
                      {
                        "id": "g",
                        "url": "https://example.com/guide",
                        "title": null,
                        "line": 4,
                        "start": 54,
                        "end": 84
                      }
                    ],
                    "unresolvedReferences": []
                  },
                  "provenance": {
                    "inputSha256": "ccee95d894907769f54aaf1e360e6c80ab1bf42b2122653d6b199624145b3914",
                    "outputSha256": "1bf4ed356d3d8cef041e5a8a5485108223c97e16499cb0b6b975c88eaf8a1414",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/html-to-text": {
      "post": {
        "operationId": "x402_html_to_text",
        "summary": "Extract HTML fragment text",
        "description": "Use to flatten supplied HTML snippets into readable text. Uses parse5 HTML parsing, decodes entities, excludes script/style/template/noscript, optionally includes image alt text, and collapses source whitespace. Block elements and br yield line breaks or spaces. No network, CSS/layout/visibility computation, sanitization guarantee, or browser rendering; hidden elements can remain. Input is parsed as an HTML fragment. Conservative limits: 1,000 less-than characters, 64 lexically open tags (explicitly close optional-end tags), and 4,096 visited parser nodes.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/html-to-text.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert HTML snippet to plain text",
            "extract readable supplied HTML"
          ],
          "whenToUse": [
            "Parse provided HTML fragments locally and omit script/style/template/noscript text."
          ],
          "whenNotToUse": [
            "URL scraping, browser-rendered visibility, or HTML security sanitization."
          ],
          "capabilities": [
            "html-to-text",
            "convert HTML snippet to plain text",
            "extract readable supplied HTML"
          ],
          "related": [
            "text-chunk",
            "whitespace-clean"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "html": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "mode": {
                    "default": "block-lines",
                    "type": "string",
                    "enum": [
                      "block-lines",
                      "single-line"
                    ]
                  },
                  "includeImageAlt": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "html"
                ],
                "additionalProperties": false
              },
              "example": {
                "html": "<h1>Report &amp; results</h1><p>Ready <strong>now</strong>.</p><script>alert(1)</script>",
                "mode": "block-lines"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "html-to-text",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 200000
                        },
                        "codeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 200000
                        },
                        "discardedElements": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "mode": {
                          "type": "string",
                          "enum": [
                            "block-lines",
                            "single-line"
                          ]
                        }
                      },
                      "required": [
                        "text",
                        "codeUnits",
                        "discardedElements",
                        "mode"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "html-to-text",
                  "version": "0.29.0",
                  "result": {
                    "text": "Report & results\nReady now.",
                    "codeUnits": 27,
                    "discardedElements": 1,
                    "mode": "block-lines"
                  },
                  "provenance": {
                    "inputSha256": "deb645af679983a18b1236c8c18ec796a8bff4badfaafcafb798490132c40238",
                    "outputSha256": "27d20e905eff93c0e09ad510a44fdff2bc51684c4132d5c34b74b2674a706e67",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/template-render": {
      "post": {
        "operationId": "x402_template_render",
        "summary": "Render literal templates",
        "description": "Use to fill deterministic text templates without evaluating code. Replaces only exact {{name}} placeholders, where names use ASCII letters/digits/underscore/dot/hyphen and start with a letter or underscore. Values are literal strings and are never re-expanded or escaped for HTML/SQL. All recognized variables must exist; other brace syntax stays literal. At most 1,000 variables, 5,000 replacements, 200,000 value units, and 500,000 output units.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/template-render.md"
        },
        "x-agent-discovery": {
          "intents": [
            "fill literal text placeholders",
            "render deterministic template"
          ],
          "whenToUse": [
            "Substitute literal named values without evaluating expressions."
          ],
          "whenNotToUse": [
            "HTML/SQL escaping, recursive templates, or executable template languages."
          ],
          "capabilities": [
            "template-render",
            "fill literal text placeholders",
            "render deterministic template"
          ],
          "related": [
            "json-schema-check"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "template": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "variables": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,63}$"
                    },
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 100000
                    }
                  }
                },
                "required": [
                  "template",
                  "variables"
                ],
                "additionalProperties": false
              },
              "example": {
                "template": "Hello {{name}}. Job {{job.id}} is {{status}}.",
                "variables": {
                  "name": "Agent",
                  "job.id": "42",
                  "status": "ready"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "template-render",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 500000
                        },
                        "replacements": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 5000
                        },
                        "usedVariables": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,63}$"
                          }
                        },
                        "unusedVariables": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,63}$"
                          }
                        }
                      },
                      "required": [
                        "text",
                        "replacements",
                        "usedVariables",
                        "unusedVariables"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "template-render",
                  "version": "0.29.0",
                  "result": {
                    "text": "Hello Agent. Job 42 is ready.",
                    "replacements": 3,
                    "usedVariables": [
                      "name",
                      "job.id",
                      "status"
                    ],
                    "unusedVariables": []
                  },
                  "provenance": {
                    "inputSha256": "74c5341f54ebf864062d826d738704c9fe696c156245de26dc47c5706e153e36",
                    "outputSha256": "d560ec304b0aa814026d40d835fd6f23ee29f356291f0cfdca3296cd2cfda8d7",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/pii-redact": {
      "post": {
        "operationId": "x402_pii_redact",
        "summary": "Redact common PII patterns",
        "description": "Use as a review aid before inspecting logs or sample text. Replaces selected ASCII email, formatted US phone, XXX-XX-XXXX SSN-shaped, and valid dotted IPv4 patterns with fixed labels; returns original-source offsets without match values. Phone patterns require separators; SSN patterns do not validate issuance. Non-exhaustive heuristics can miss PII and produce false positives. Never a security, compliance, or anonymization guarantee. Maximum 10,000 matches.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/pii-redact.md"
        },
        "x-agent-discovery": {
          "intents": [
            "redact common personal data patterns",
            "mask email phone SSN IPv4"
          ],
          "whenToUse": [
            "Aid review by masking a bounded set of common ASCII patterns."
          ],
          "whenNotToUse": [
            "Complete anonymization, legal compliance, or exhaustive PII detection."
          ],
          "capabilities": [
            "pii-redact",
            "redact common personal data patterns",
            "mask email phone SSN IPv4"
          ],
          "related": [
            "text-chunk"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "types": {
                    "default": [
                      "email",
                      "us-phone"
                    ],
                    "minItems": 1,
                    "maxItems": 4,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "email",
                        "us-phone",
                        "us-ssn",
                        "ipv4"
                      ]
                    }
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Email alex@example.com or call (415) 555-2671. Host: 192.168.1.20",
                "types": [
                  "email",
                  "us-phone",
                  "ipv4"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "pii-redact",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 300000
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 10000
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "email": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 10000
                            },
                            "usPhone": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 10000
                            },
                            "usSsn": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 10000
                            },
                            "ipv4": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 10000
                            }
                          },
                          "required": [
                            "email",
                            "usPhone",
                            "usSsn",
                            "ipv4"
                          ],
                          "additionalProperties": false
                        },
                        "redactions": {
                          "maxItems": 10000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "email",
                                  "us-phone",
                                  "us-ssn",
                                  "ipv4"
                                ]
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "replacement": {
                                "type": "string",
                                "enum": [
                                  "[EMAIL]",
                                  "[US_PHONE]",
                                  "[US_SSN]",
                                  "[IPV4]"
                                ]
                              }
                            },
                            "required": [
                              "type",
                              "start",
                              "end",
                              "replacement"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "warning": {
                          "type": "string",
                          "const": "Pattern-only redaction is non-exhaustive and can miss personal data or redact non-personal text. Do not rely on it as a security, compliance, or anonymization guarantee."
                        }
                      },
                      "required": [
                        "text",
                        "offsetUnit",
                        "count",
                        "counts",
                        "redactions",
                        "warning"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "pii-redact",
                  "version": "0.29.0",
                  "result": {
                    "text": "Email [EMAIL] or call [US_PHONE]. Host: [IPV4]",
                    "offsetUnit": "UTF-16 code units; zero-based, end-exclusive",
                    "count": 3,
                    "counts": {
                      "email": 1,
                      "usPhone": 1,
                      "usSsn": 0,
                      "ipv4": 1
                    },
                    "redactions": [
                      {
                        "type": "email",
                        "start": 6,
                        "end": 22,
                        "replacement": "[EMAIL]"
                      },
                      {
                        "type": "us-phone",
                        "start": 31,
                        "end": 45,
                        "replacement": "[US_PHONE]"
                      },
                      {
                        "type": "ipv4",
                        "start": 53,
                        "end": 65,
                        "replacement": "[IPV4]"
                      }
                    ],
                    "warning": "Pattern-only redaction is non-exhaustive and can miss personal data or redact non-personal text. Do not rely on it as a security, compliance, or anonymization guarantee."
                  },
                  "provenance": {
                    "inputSha256": "0d19138edb2e9fa39d38a91b2e8c426bca6d4a4d1835907c24f4870e848417b1",
                    "outputSha256": "6fee41bce2920ef0b94b502c04da6a3d876729b5195cade74c92883778ff91a2",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/whitespace-clean": {
      "post": {
        "operationId": "x402_whitespace_clean",
        "summary": "Clean document whitespace",
        "description": "Use for predictable whitespace cleanup before diffing or storing text. Normalizes CR/LF separators to LF or CRLF, optionally collapses ASCII spaces/tabs, trims selected line edges, limits consecutive blank lines, and removes outer blank lines. Blank lines contain only spaces/tabs; other Unicode whitespace is preserved. Set maxBlankLines to null to preserve every blank line. This can change indentation-sensitive documents.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/whitespace-clean.md"
        },
        "x-agent-discovery": {
          "intents": [
            "normalize whitespace line endings",
            "trim document blank lines"
          ],
          "whenToUse": [
            "Apply explicit line separator and ASCII whitespace cleanup."
          ],
          "whenNotToUse": [
            "Preserving all indentation-sensitive semantics automatically."
          ],
          "capabilities": [
            "whitespace-clean",
            "normalize whitespace line endings",
            "trim document blank lines"
          ],
          "related": [
            "lines-diff",
            "unicode-normalize"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "lineEnding": {
                    "default": "lf",
                    "type": "string",
                    "enum": [
                      "lf",
                      "crlf"
                    ]
                  },
                  "trimLineEdges": {
                    "default": "right",
                    "type": "string",
                    "enum": [
                      "none",
                      "right",
                      "both"
                    ]
                  },
                  "collapseHorizontalWhitespace": {
                    "default": false,
                    "type": "boolean"
                  },
                  "maxBlankLines": {
                    "default": 2,
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 20
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "trimOuterBlankLines": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "  Keep indent  \r\n\r\n\r\nNext\t  word \r\n",
                "collapseHorizontalWhitespace": true,
                "maxBlankLines": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "whitespace-clean",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 200000
                        },
                        "changed": {
                          "type": "boolean"
                        },
                        "originalCodeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "resultCodeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 200000
                        },
                        "inputLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "outputLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "lineEnding": {
                          "type": "string",
                          "enum": [
                            "lf",
                            "crlf"
                          ]
                        }
                      },
                      "required": [
                        "text",
                        "changed",
                        "originalCodeUnits",
                        "resultCodeUnits",
                        "inputLines",
                        "outputLines",
                        "lineEnding"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "whitespace-clean",
                  "version": "0.29.0",
                  "result": {
                    "text": " Keep indent\n\nNext word",
                    "changed": true,
                    "originalCodeUnits": 35,
                    "resultCodeUnits": 23,
                    "inputLines": 5,
                    "outputLines": 3,
                    "lineEnding": "lf"
                  },
                  "provenance": {
                    "inputSha256": "082a1ccf8ba7deeac006ca84e9cd89c620dcdd69898f7e947a445dfa9c303ba0",
                    "outputSha256": "a4d5b09671c6b6b3d6d9827310dbdb380a7d486b80675b6c0a55f8cc2f012667",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/yaml-to-json": {
      "post": {
        "operationId": "x402_yaml_to_json",
        "summary": "Yaml To Json",
        "description": "Use to turn bounded YAML 1.2 configuration into JSON before agent tool calls. Rejects duplicate keys, custom tags, non-JSON values, and aliases.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/yaml-to-json.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert YAML config into JSON",
            "parse YAML 1.2"
          ],
          "whenToUse": [
            "Convert bounded YAML configuration into a JSON object, array or scalar without aliases or custom tags."
          ],
          "whenNotToUse": [
            "Arbitrary YAML objects, alias expansion, or executable tags."
          ],
          "capabilities": [
            "yaml-to-json",
            "convert YAML config into JSON",
            "parse YAML 1.2"
          ],
          "related": [
            "json-schema-check",
            "json-to-yaml"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "yaml": {
                    "type": "string",
                    "maxLength": 20000
                  }
                },
                "required": [
                  "yaml"
                ],
                "additionalProperties": false
              },
              "example": {
                "yaml": "name: agent\nretries: 3"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "yaml-to-json",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "value": {
                          "$ref": "#/paths/~1v1~1x402~1yaml-to-json/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        }
                      },
                      "required": [
                        "value"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1yaml-to-json/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1yaml-to-json/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "yaml-to-json",
                  "version": "0.29.0",
                  "result": {
                    "value": {
                      "name": "agent",
                      "retries": 3
                    }
                  },
                  "provenance": {
                    "inputSha256": "6dccb7a35faadb360f30610ffce468799e47eebfc7526086878cf69902de5a9c",
                    "outputSha256": "54ad11b20706b7cf42f112084c88842598a0c2b4c7cb79e8107ae5211e0b238c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-to-yaml": {
      "post": {
        "operationId": "x402_json_to_yaml",
        "summary": "Json To Yaml",
        "description": "Use to create human-reviewable YAML 1.2 from a JSON tool result; preserves JSON scalar types and emits no aliases.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-to-yaml.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert JSON into YAML",
            "emit readable YAML configuration"
          ],
          "whenToUse": [
            "Serialize supplied JSON scalar/container values as YAML 1.2."
          ],
          "whenNotToUse": [
            "Preserving prior YAML comments, aliases, or original formatting."
          ],
          "capabilities": [
            "json-to-yaml",
            "convert JSON into YAML",
            "emit readable YAML configuration"
          ],
          "related": [
            "yaml-to-json"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "value": {
                    "$ref": "#/paths/~1v1~1x402~1json-to-yaml/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "indent": {
                    "default": 2,
                    "type": "integer",
                    "minimum": 2,
                    "maximum": 8
                  }
                },
                "required": [
                  "value"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-to-yaml/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-to-yaml/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "value": {
                  "name": "agent",
                  "retries": 3
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-to-yaml",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "yaml": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "yaml"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-to-yaml",
                  "version": "0.29.0",
                  "result": {
                    "yaml": "name: agent\nretries: 3\n"
                  },
                  "provenance": {
                    "inputSha256": "b0c81b7f5d676de7d226abf52cc7881ea2488cd93781caffa2d89fa3219facad",
                    "outputSha256": "5777d97ab33f650c829b48c96a2a4e405271e756e0ee271289607fa5a5d98478",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-schema-check": {
      "post": {
        "operationId": "x402_json_schema_check",
        "summary": "Json Schema Check",
        "description": "Use to validate tool output with a bounded JSON Schema subset: scalar types, objects, arrays, enum/const, limits and combinators. Rejects $ref, regex and unsupported keywords; not a full draft validator.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-schema-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "validate JSON tool output",
            "check instance against JSON Schema subset"
          ],
          "whenToUse": [
            "Validate a supplied value against the explicitly supported bounded schema subset."
          ],
          "whenNotToUse": [
            "Full JSON Schema draft conformance, $ref resolution, or regex validation."
          ],
          "capabilities": [
            "json-schema-check",
            "validate JSON tool output",
            "check instance against JSON Schema subset"
          ],
          "related": [
            "json-schema-compatibility",
            "json-patch"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "schema": {
                    "$ref": "#/paths/~1v1~1x402~1json-schema-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "value": {
                    "$ref": "#/paths/~1v1~1x402~1json-schema-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "schema",
                  "value"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-schema-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-schema-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "schema": {
                  "type": "object",
                  "required": [
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer"
                    }
                  },
                  "additionalProperties": false
                },
                "value": {
                  "id": 7
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-schema-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "valid": {
                          "type": "boolean"
                        },
                        "errors": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "keyword": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "path",
                              "keyword",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "dialect": {
                          "type": "string",
                          "const": "safe-json-schema-subset-v1"
                        }
                      },
                      "required": [
                        "valid",
                        "errors",
                        "dialect"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-schema-check",
                  "version": "0.29.0",
                  "result": {
                    "valid": true,
                    "errors": [],
                    "dialect": "safe-json-schema-subset-v1"
                  },
                  "provenance": {
                    "inputSha256": "971d014766eee8eca7005efb4ccfea7ec0ed8f935b36be0a8e78661e68e349de",
                    "outputSha256": "48544e032ed51afc6370091e94ab446016238de6d599c548815570845e7efd5e",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/base64-convert": {
      "post": {
        "operationId": "x402_base64_convert",
        "summary": "Base64 Convert",
        "description": "Use to convert UTF-8 text to canonical Base64/Base64url or decode it. Rejects malformed encodings and non-UTF-8 decoded bytes.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/base64-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "encode decode base64 text",
            "convert base64url UTF-8"
          ],
          "whenToUse": [
            "Encode UTF-8 text or decode canonical base64 encodings."
          ],
          "whenNotToUse": [
            "Arbitrary binary files or cryptographic encryption."
          ],
          "capabilities": [
            "base64-convert",
            "encode decode base64 text",
            "convert base64url UTF-8"
          ],
          "related": [
            "content-digest"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "direction": {
                    "type": "string",
                    "enum": [
                      "encode",
                      "decode"
                    ]
                  },
                  "urlSafe": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text",
                  "direction"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Hello, agent",
                "direction": "encode",
                "urlSafe": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "base64-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string"
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "text",
                        "byteLength"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "base64-convert",
                  "version": "0.29.0",
                  "result": {
                    "text": "SGVsbG8sIGFnZW50",
                    "byteLength": 12
                  },
                  "provenance": {
                    "inputSha256": "4e0e9460a9100c39b78fabf62c5dca183b314f3ddb5f64973f735385f9754137",
                    "outputSha256": "d0d25ee6154f44dc80488e7e63bf61fde968d06cad53aebf97df0a118d9e97f4",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/url-inspect": {
      "post": {
        "operationId": "x402_url_inspect",
        "summary": "Url Inspect",
        "description": "Use to parse and normalize an HTTP(S) URL without fetching it. Returns origin, IDNA host, port and query pairs. Rejects credentials; normalization does not certify URL safety.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/url-inspect.md"
        },
        "x-agent-discovery": {
          "intents": [
            "parse HTTP URL components",
            "normalize URL hostname query"
          ],
          "whenToUse": [
            "Inspect supplied HTTP(S) URLs with IDNA normalization without fetching."
          ],
          "whenNotToUse": [
            "SSRF protection, reputation verdicts, DNS lookup, or live link checks."
          ],
          "capabilities": [
            "url-inspect",
            "parse HTTP URL components",
            "normalize URL hostname query"
          ],
          "related": [
            "querystring-convert"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "maxLength": 8192
                  },
                  "removeFragment": {
                    "default": true,
                    "type": "boolean"
                  },
                  "sortQuery": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "url"
                ],
                "additionalProperties": false
              },
              "example": {
                "url": "https://EXAMPLE.com:443/a?z=2&a=1#part",
                "sortQuery": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "url-inspect",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string"
                        },
                        "origin": {
                          "type": "string"
                        },
                        "hostname": {
                          "type": "string"
                        },
                        "port": {
                          "type": "string"
                        },
                        "path": {
                          "type": "string"
                        },
                        "query": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "prefixItems": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "items": false,
                            "minItems": 2,
                            "maxItems": 2
                          }
                        },
                        "fragment": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "url",
                        "origin",
                        "hostname",
                        "port",
                        "path",
                        "query",
                        "fragment"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "url-inspect",
                  "version": "0.29.0",
                  "result": {
                    "url": "https://example.com/a?a=1&z=2",
                    "origin": "https://example.com",
                    "hostname": "example.com",
                    "port": "",
                    "path": "/a",
                    "query": [
                      [
                        "a",
                        "1"
                      ],
                      [
                        "z",
                        "2"
                      ]
                    ],
                    "fragment": ""
                  },
                  "provenance": {
                    "inputSha256": "fc8c577f79a2a523785334ddf0e12cf64b239641127dc5ff558c33023346184a",
                    "outputSha256": "a313dc97ab163bf32c33c5fd64d2825aeaeecc68d64ce2fc016b35009853a97f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/querystring-convert": {
      "post": {
        "operationId": "x402_querystring_convert",
        "summary": "Querystring Convert",
        "description": "Use to encode query parameter pairs or decode application/x-www-form-urlencoded query strings while preserving duplicate keys and order.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/querystring-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "encode decode query parameters",
            "preserve duplicate URL query keys"
          ],
          "whenToUse": [
            "Convert ordered parameter pairs to/from form-urlencoded strings."
          ],
          "whenNotToUse": [
            "Nested bracket object conventions or URL fetching."
          ],
          "capabilities": [
            "querystring-convert",
            "encode decode query parameters",
            "preserve duplicate URL query keys"
          ],
          "related": [
            "url-inspect"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "direction": {
                        "type": "string",
                        "const": "decode"
                      },
                      "query": {
                        "type": "string",
                        "maxLength": 100000
                      }
                    },
                    "required": [
                      "direction",
                      "query"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "direction": {
                        "type": "string",
                        "const": "encode"
                      },
                      "pairs": {
                        "maxItems": 1000,
                        "type": "array",
                        "items": {
                          "type": "array",
                          "prefixItems": [
                            {
                              "type": "string",
                              "maxLength": 2048
                            },
                            {
                              "type": "string",
                              "maxLength": 8192
                            }
                          ],
                          "items": false,
                          "minItems": 2,
                          "maxItems": 2
                        }
                      },
                      "sort": {
                        "default": false,
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "direction",
                      "pairs"
                    ],
                    "additionalProperties": false
                  }
                ]
              },
              "example": {
                "direction": "decode",
                "query": "tag=one&tag=two&q=hello+world"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "querystring-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "query": {
                          "type": "string"
                        },
                        "pairs": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "prefixItems": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "items": false,
                            "minItems": 2,
                            "maxItems": 2
                          }
                        }
                      },
                      "required": [
                        "query",
                        "pairs"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "querystring-convert",
                  "version": "0.29.0",
                  "result": {
                    "query": "tag=one&tag=two&q=hello+world",
                    "pairs": [
                      [
                        "tag",
                        "one"
                      ],
                      [
                        "tag",
                        "two"
                      ],
                      [
                        "q",
                        "hello world"
                      ]
                    ]
                  },
                  "provenance": {
                    "inputSha256": "111fcf375abf0e34e89d8467017803fa5d8e6edda1bcb879cef1ba7cbef98079",
                    "outputSha256": "18b88b619e57cf36f96454a3efd13c409ba3de0f307957ec89dba1c7a2bab5ed",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/http-headers-normalize": {
      "post": {
        "operationId": "x402_http_headers_normalize",
        "summary": "Http Headers Normalize",
        "description": "Use to validate and lowercase HTTP field names and trim field values before signing or comparing requests. Preserves repeated headers as arrays and does not combine Set-Cookie.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-headers-normalize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "normalize HTTP headers",
            "validate repeated header fields"
          ],
          "whenToUse": [
            "Validate HTTP field names and trim values while preserving repeated Set-Cookie headers and multiple values."
          ],
          "whenNotToUse": [
            "HTTP request transmission or combining Set-Cookie into one field."
          ],
          "capabilities": [
            "http-headers-normalize",
            "normalize HTTP headers",
            "validate repeated header fields"
          ],
          "related": [
            "openapi-request-check"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "headers": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256
                        },
                        {
                          "type": "string",
                          "maxLength": 8192
                        }
                      ],
                      "items": false,
                      "minItems": 2,
                      "maxItems": 2
                    }
                  }
                },
                "required": [
                  "headers"
                ],
                "additionalProperties": false
              },
              "example": {
                "headers": [
                  [
                    "Content-Type",
                    " application/json "
                  ],
                  [
                    "X-Tag",
                    "a"
                  ],
                  [
                    "x-tag",
                    "b"
                  ]
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-headers-normalize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "headers": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "names": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "headers",
                        "names"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-headers-normalize",
                  "version": "0.29.0",
                  "result": {
                    "headers": {
                      "content-type": [
                        "application/json"
                      ],
                      "x-tag": [
                        "a",
                        "b"
                      ]
                    },
                    "names": [
                      "content-type",
                      "x-tag"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "a11215cff82614f63e1c8ed1b11d5b4d4e1cef7e47e88a27cfc3a598317dcf01",
                    "outputSha256": "c47fe2f012fd910ff4b29b246e4975b71bdeecf02fb61402dc6c2986a3904c4f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/content-digest": {
      "post": {
        "operationId": "x402_content_digest",
        "summary": "Content Digest",
        "description": "Use to fingerprint UTF-8 payloads for content-addressing, cache keys and integrity comparisons. Computes SHA-256/384/512; this is not a signature or authentication service.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/content-digest.md"
        },
        "x-agent-discovery": {
          "intents": [
            "hash text SHA256 SHA384 SHA512",
            "fingerprint payload integrity"
          ],
          "whenToUse": [
            "Compute a SHA digest of supplied UTF-8 text."
          ],
          "whenNotToUse": [
            "Authentication, digital signatures, encryption, or file downloading."
          ],
          "capabilities": [
            "content-digest",
            "hash text SHA256 SHA384 SHA512",
            "fingerprint payload integrity"
          ],
          "related": [
            "json-canonicalize"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "algorithm": {
                    "default": "SHA-256",
                    "type": "string",
                    "enum": [
                      "SHA-256",
                      "SHA-384",
                      "SHA-512"
                    ]
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "hello",
                "algorithm": "SHA-256"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "content-digest",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "algorithm": {
                          "type": "string"
                        },
                        "hex": {
                          "type": "string"
                        },
                        "base64": {
                          "type": "string"
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "algorithm",
                        "hex",
                        "base64",
                        "byteLength"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "content-digest",
                  "version": "0.29.0",
                  "result": {
                    "algorithm": "SHA-256",
                    "hex": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
                    "base64": "LPJNul+wow4m6DsqxbninhsWHlwfp0JecwQzYpOLmCQ=",
                    "byteLength": 5
                  },
                  "provenance": {
                    "inputSha256": "32dc8f587f9d0b79d59534d4c0955439356a01a25c9c7bbbee0b341360c024f7",
                    "outputSha256": "3b04feb68946ce52454b91f05fdf0026dda4d026a03bb7c5b9dc530ccf6026d6",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/timestamp-convert": {
      "post": {
        "operationId": "x402_timestamp_convert",
        "summary": "Timestamp Convert",
        "description": "Use to normalize RFC3339 timestamps with an explicit offset or Unix epoch milliseconds into UTC ISO text, epoch milliseconds and epoch seconds. Rejects rollover dates and leap seconds.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/timestamp-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert timestamp epoch UTC",
            "normalize RFC3339 date offset"
          ],
          "whenToUse": [
            "Convert strict offset timestamps or epoch milliseconds into UTC."
          ],
          "whenNotToUse": [
            "Natural-language dates, missing timezones, or leap seconds."
          ],
          "capabilities": [
            "timestamp-convert",
            "convert timestamp epoch UTC",
            "normalize RFC3339 date offset"
          ],
          "related": [
            "duration-convert"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 64
                      },
                      {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      }
                    ]
                  }
                },
                "required": [
                  "value"
                ],
                "additionalProperties": false
              },
              "example": {
                "value": "2026-10-04T14:30:00-04:00"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "timestamp-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "iso": {
                          "type": "string"
                        },
                        "epochMilliseconds": {
                          "type": "number"
                        },
                        "epochSeconds": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "iso",
                        "epochMilliseconds",
                        "epochSeconds"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "timestamp-convert",
                  "version": "0.29.0",
                  "result": {
                    "iso": "2026-10-04T18:30:00.000Z",
                    "epochMilliseconds": 1791138600000,
                    "epochSeconds": 1791138600
                  },
                  "provenance": {
                    "inputSha256": "27fe29dbd2ca1ceba9a420fcf1637432ce53b78d2a2c42251db7feb97031c8df",
                    "outputSha256": "18db30fca1c0e812885bdac5dc00e010c71538792b0f553696b26d3fbe6a2505",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/duration-convert": {
      "post": {
        "operationId": "x402_duration_convert",
        "summary": "Duration Convert",
        "description": "Use to convert fixed ISO8601 durations (days, hours, minutes, seconds) to seconds and a canonical duration. Calendar years/months/weeks and negative values are deliberately unsupported.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/duration-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert ISO8601 duration seconds",
            "normalize fixed elapsed duration"
          ],
          "whenToUse": [
            "Convert fixed day/hour/minute/second durations."
          ],
          "whenNotToUse": [
            "Calendar months, years, weeks, negative durations, or date arithmetic."
          ],
          "capabilities": [
            "duration-convert",
            "convert ISO8601 duration seconds",
            "normalize fixed elapsed duration"
          ],
          "related": [
            "timestamp-convert"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 100
                      },
                      {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 315576000000
                      }
                    ]
                  }
                },
                "required": [
                  "value"
                ],
                "additionalProperties": false
              },
              "example": {
                "value": "P1DT2H30M"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "duration-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "seconds": {
                          "type": "number"
                        },
                        "milliseconds": {
                          "type": "number"
                        },
                        "iso": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "seconds",
                        "milliseconds",
                        "iso"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "duration-convert",
                  "version": "0.29.0",
                  "result": {
                    "seconds": 95400,
                    "milliseconds": 95400000,
                    "iso": "P1DT2H30M"
                  },
                  "provenance": {
                    "inputSha256": "030b4db0748feeea638dcb701d69947537ed73badf6fda8005bc4a89b29dee94",
                    "outputSha256": "1b0fef70720f9b3ee94657602d6a31b93da7e8a2c6446e9826e806c61c8ec704",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/units-convert": {
      "post": {
        "operationId": "x402_units_convert",
        "summary": "Units Convert",
        "description": "Use for deterministic length, mass, time, byte-size or temperature conversions in agent tool inputs. Explicit case-sensitive units distinguish MB from MiB; rejects incompatible dimensions.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/units-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert measurement units",
            "length mass bytes temperature conversion"
          ],
          "whenToUse": [
            "Convert explicitly supported compatible dimensions."
          ],
          "whenNotToUse": [
            "Currencies, exchange rates, or unit guessing."
          ],
          "capabilities": [
            "units-convert",
            "convert measurement units",
            "length mass bytes temperature conversion"
          ],
          "related": [
            "duration-convert"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "value": {
                    "type": "number"
                  },
                  "from": {
                    "type": "string",
                    "enum": [
                      "m",
                      "km",
                      "cm",
                      "mm",
                      "in",
                      "ft",
                      "yd",
                      "mi",
                      "kg",
                      "g",
                      "lb",
                      "oz",
                      "s",
                      "ms",
                      "min",
                      "h",
                      "day",
                      "B",
                      "kB",
                      "MB",
                      "GB",
                      "KiB",
                      "MiB",
                      "GiB",
                      "K",
                      "C",
                      "F"
                    ]
                  },
                  "to": {
                    "type": "string",
                    "enum": [
                      "m",
                      "km",
                      "cm",
                      "mm",
                      "in",
                      "ft",
                      "yd",
                      "mi",
                      "kg",
                      "g",
                      "lb",
                      "oz",
                      "s",
                      "ms",
                      "min",
                      "h",
                      "day",
                      "B",
                      "kB",
                      "MB",
                      "GB",
                      "KiB",
                      "MiB",
                      "GiB",
                      "K",
                      "C",
                      "F"
                    ]
                  }
                },
                "required": [
                  "value",
                  "from",
                  "to"
                ],
                "additionalProperties": false
              },
              "example": {
                "value": 1,
                "from": "MiB",
                "to": "B"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "units-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "value": {
                          "type": "number"
                        },
                        "from": {
                          "type": "string"
                        },
                        "to": {
                          "type": "string"
                        },
                        "dimension": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "value",
                        "from",
                        "to",
                        "dimension"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "units-convert",
                  "version": "0.29.0",
                  "result": {
                    "value": 1048576,
                    "from": "MiB",
                    "to": "B",
                    "dimension": "data"
                  },
                  "provenance": {
                    "inputSha256": "283e4f337eba36d2e65f0fb7cbc0b0f22ff870b5052453c9b04aec9d504751a3",
                    "outputSha256": "be9271b7b12f85591743aeaae670ca317fd4611802446a6546c7a08b8cbad333",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/semver-evaluate": {
      "post": {
        "operationId": "x402_semver_evaluate",
        "summary": "Semver Evaluate",
        "description": "Use to compare strict Semantic Versioning versions and evaluate npm-compatible version ranges before choosing a package. Prerelease matching is excluded by default unless the range explicitly allows it.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/semver-evaluate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compare semantic versions",
            "check whether a version satisfies an npm caret dependency range"
          ],
          "whenToUse": [
            "Compare strict versions and check npm-compatible ranges."
          ],
          "whenNotToUse": [
            "Looking up package releases, vulnerabilities, or non-SemVer version systems."
          ],
          "capabilities": [
            "semver-evaluate",
            "compare semantic versions",
            "check whether a version satisfies an npm caret dependency range"
          ],
          "related": [
            "lockfile-inventory",
            "json-schema-compatibility"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "version": {
                    "type": "string",
                    "maxLength": 256
                  },
                  "against": {
                    "type": "string",
                    "maxLength": 256
                  },
                  "range": {
                    "type": "string",
                    "maxLength": 1024
                  },
                  "includePrerelease": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "version",
                  "against"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": "2.3.1",
                "against": "2.2.0",
                "range": "^2.0.0"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "semver-evaluate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "against": {
                          "type": "string"
                        },
                        "comparison": {
                          "type": "integer",
                          "minimum": -1,
                          "maximum": 1
                        },
                        "satisfies": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "prerelease": {
                          "type": "array",
                          "items": {
                            "type": [
                              "string",
                              "number"
                            ]
                          }
                        }
                      },
                      "required": [
                        "version",
                        "against",
                        "comparison",
                        "satisfies",
                        "prerelease"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "semver-evaluate",
                  "version": "0.29.0",
                  "result": {
                    "version": "2.3.1",
                    "against": "2.2.0",
                    "comparison": 1,
                    "satisfies": true,
                    "prerelease": []
                  },
                  "provenance": {
                    "inputSha256": "6344dd6d2cf1f4675e8f6d45100b01973e77537f2032c3c1a9b76cc85ae23e1a",
                    "outputSha256": "5976f73e251f9e706bc064e66edb7ad1e151142e4187fa32b3b175e7ee92ed3c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/openapi-lint": {
      "post": {
        "operationId": "x402_openapi_lint",
        "summary": "OpenAPI Agent Lint",
        "description": "Find actionable agent-integration problems in supplied OpenAPI 3.1.x JSON: unique operation IDs, response shape, path parameters and security references. Paths-only lint; references are reported without resolution. At most 100 paths/200 operations/200 retained findings; not full specification validation.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/openapi-lint.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Review an OpenAPI 3.1 contract before wiring an agent client",
            "Locate repairable contract defects with JSON Pointer findings",
            "Find duplicate operation IDs, missing path parameters and response definitions"
          ],
          "whenToUse": [
            "Review an OpenAPI 3.1 contract before wiring an agent client",
            "Locate repairable contract defects with JSON Pointer findings",
            "Find duplicate operation IDs, missing path parameters and response definitions"
          ],
          "whenNotToUse": [
            "Full OpenAPI conformance or remote reference resolution",
            "Authentication/security certification"
          ],
          "capabilities": [
            "Stable finding codes and repair suggestions",
            "100 paths, 200 operations, 200 findings; 110,000 UTF-8 input bytes"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "paths": 100,
            "operations": 200,
            "effectiveParameters": 100,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1x402~1openapi-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "document"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "openapi": "3.1.0",
                  "info": {
                    "title": "Orders",
                    "version": "1.0.0"
                  },
                  "paths": {
                    "/orders/{id}": {
                      "get": {
                        "operationId": "getOrder",
                        "summary": "Read one order",
                        "parameters": [
                          {
                            "name": "id",
                            "in": "path",
                            "required": true,
                            "schema": {
                              "type": "integer",
                              "minimum": 1
                            }
                          }
                        ],
                        "responses": {
                          "200": {
                            "description": "Order"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "openapi-lint",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "openapi-3.1-agent-lint-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "complete": {
                          "type": "boolean",
                          "const": false
                        },
                        "operationCount": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "unsupportedCount": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "suggestion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "suggestion"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "complete",
                        "operationCount",
                        "errorCount",
                        "unsupportedCount",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "openapi-lint",
                  "version": "0.29.0",
                  "result": {
                    "profile": "openapi-3.1-agent-lint-v1",
                    "passesChecks": true,
                    "complete": false,
                    "operationCount": 1,
                    "errorCount": 0,
                    "unsupportedCount": 0,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "36ca6a850c156b929adea6a02d38f21cd8a9b62818414af00e4207e5d5912c42",
                    "outputSha256": "853f3aff9faf12ac5ee5bb4739a0170f11f990db8ecfcc896233fae6eb0f5169",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/openapi-operation-inventory": {
      "post": {
        "operationId": "x402_openapi_operation_inventory",
        "summary": "OpenAPI Operation Inventory",
        "description": "Extract a bounded agent planning inventory of methods, templates, parameters, media types, response codes, and effective security declarations from OpenAPI 3.1.x. Reports lint coverage and unresolved references; does not call endpoints or resolve schemas.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/openapi-operation-inventory.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Plan which API operations and authentication schemes an agent needs",
            "Audit operation coverage before client generation"
          ],
          "whenToUse": [
            "Plan which API operations and authentication schemes an agent needs",
            "Audit operation coverage before client generation"
          ],
          "whenNotToUse": [
            "Discovering live endpoint availability",
            "Resolving referenced parameters or testing credentials"
          ],
          "capabilities": [
            "Effective path/operation parameter overrides",
            "Declared anonymous alternatives and security inheritance"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "paths": 100,
            "operations": 200,
            "effectiveParameters": 100,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1x402~1openapi-operation-inventory/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "document"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-operation-inventory/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-operation-inventory/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "openapi": "3.1.0",
                  "info": {
                    "title": "Orders",
                    "version": "1.0.0"
                  },
                  "paths": {
                    "/orders/{id}": {
                      "get": {
                        "operationId": "getOrder",
                        "summary": "Read one order",
                        "parameters": [
                          {
                            "name": "id",
                            "in": "path",
                            "required": true,
                            "schema": {
                              "type": "integer",
                              "minimum": 1
                            }
                          }
                        ],
                        "responses": {
                          "200": {
                            "description": "Order"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "openapi-operation-inventory",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "openapi-3.1-operation-inventory-v1"
                        },
                        "operations": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "method": {
                                "type": "string",
                                "enum": [
                                  "get",
                                  "put",
                                  "post",
                                  "delete",
                                  "options",
                                  "head",
                                  "patch",
                                  "trace"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "operationId": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "summary": {
                                "type": "string"
                              },
                              "parameters": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string"
                                    },
                                    "location": {
                                      "type": "string"
                                    },
                                    "required": {
                                      "type": "boolean"
                                    },
                                    "hasReference": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "location",
                                    "required",
                                    "hasReference"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "requestMediaTypes": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "responseCodes": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "securitySchemes": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "anonymousAllowed": {
                                "type": "boolean"
                              },
                              "securitySource": {
                                "type": "string",
                                "enum": [
                                  "operation",
                                  "document",
                                  "absent"
                                ]
                              }
                            },
                            "required": [
                              "method",
                              "path",
                              "operationId",
                              "summary",
                              "parameters",
                              "requestMediaTypes",
                              "responseCodes",
                              "securitySchemes",
                              "anonymousAllowed",
                              "securitySource"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "suggestion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "suggestion"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "operations",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "openapi-operation-inventory",
                  "version": "0.29.0",
                  "result": {
                    "profile": "openapi-3.1-operation-inventory-v1",
                    "operations": [
                      {
                        "method": "get",
                        "path": "/orders/{id}",
                        "operationId": "getOrder",
                        "summary": "Read one order",
                        "parameters": [
                          {
                            "name": "id",
                            "location": "path",
                            "required": true,
                            "hasReference": false
                          }
                        ],
                        "requestMediaTypes": [],
                        "responseCodes": [
                          "200"
                        ],
                        "securitySchemes": [],
                        "anonymousAllowed": true,
                        "securitySource": "absent"
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "36ca6a850c156b929adea6a02d38f21cd8a9b62818414af00e4207e5d5912c42",
                    "outputSha256": "4b89429d94aa232b3f033c4f56e436e180e8f5b2260005c47845ca678f47e922",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-schema-compatibility": {
      "post": {
        "operationId": "x402_json_schema_compatibility",
        "summary": "JSON Schema Compatibility Evidence",
        "description": "Conservatively test whether all values accepted by a previous typed JSON Schema subset remain accepted by a next schema. Returns compatible only after a structural inclusion proof, incompatible only with a verified counterexample, otherwise unknown. Supports explicit single types, object/array constraints, enum/const and inclusive bounds; no refs/combinators/regex.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-schema-compatibility.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Gate an agent tool input-schema upgrade for backward acceptance",
            "Get concrete evidence for a breaking schema change"
          ],
          "whenToUse": [
            "Gate an agent tool input-schema upgrade for backward acceptance",
            "Get concrete evidence for a breaking schema change"
          ],
          "whenNotToUse": [
            "General JSON Schema subsumption",
            "Deciding behavior compatibility or security from schemas alone"
          ],
          "capabilities": [
            "Conservative three-state result with verified counterexamples",
            "128 schema nodes, 12 schema levels, 64 properties, 50,000 evaluations"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "schemaNodes": 128,
            "schemaDepth": 12,
            "schemaProperties": 64,
            "evaluations": 50000,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "previous": {
                    "$ref": "#/paths/~1v1~1x402~1json-schema-compatibility/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "next": {
                    "$ref": "#/paths/~1v1~1x402~1json-schema-compatibility/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "previous",
                  "next"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-schema-compatibility/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-schema-compatibility/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "previous": {
                  "type": "object",
                  "required": [
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer",
                      "minimum": 1
                    }
                  },
                  "additionalProperties": false
                },
                "next": {
                  "type": "object",
                  "required": [
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "number",
                      "minimum": 0
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-schema-compatibility",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "typed-schema-subset-v1"
                        },
                        "direction": {
                          "type": "string",
                          "const": "previous-values-accepted-by-next"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "compatible",
                            "incompatible",
                            "unknown"
                          ]
                        },
                        "reason": {
                          "type": "string"
                        },
                        "counterexample": {
                          "$ref": "#/paths/~1v1~1x402~1json-schema-compatibility/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "suggestion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "suggestion"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "direction",
                        "status",
                        "reason",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-schema-compatibility/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-schema-compatibility/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-schema-compatibility",
                  "version": "0.29.0",
                  "result": {
                    "profile": "typed-schema-subset-v1",
                    "direction": "previous-values-accepted-by-next",
                    "status": "compatible",
                    "reason": "Structural inclusion is proven within the supported typed-schema subset",
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "dd27f1605af650c8b48ed4422054aaed98c3bc8afa80c4533f79b96fdc2e4b31",
                    "outputSha256": "e02b5cd7e5d59488f52186284375a3d78ab30aca31037483aebc2767711f5b4a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-schema-to-tool": {
      "post": {
        "operationId": "x402_json_schema_to_tool",
        "summary": "JSON Schema to MCP Tool Descriptor",
        "description": "Wrap a supported object-root JSON Schema in a deterministic MCP tool descriptor, optionally with an object-root output schema. Rejects unsupported keywords instead of silently weakening constraints. Does not deploy a tool, execute code, or claim provider-specific strict function compatibility.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-schema-to-tool.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Create a named MCP tool descriptor from an object input schema",
            "Adapt a bounded JSON object schema into a tool definition",
            "Preserve schema constraints during tool registration preparation"
          ],
          "whenToUse": [
            "Create a named MCP tool descriptor from an object input schema",
            "Adapt a bounded JSON object schema into a tool definition",
            "Preserve schema constraints during tool registration preparation"
          ],
          "whenNotToUse": [
            "OpenAI strict-mode conversion or arbitrary JSON Schema conversion",
            "Installing or running an MCP server"
          ],
          "capabilities": [
            "No lossy keyword removal or execution",
            "OBJECT_SCHEMA_REQUIRED and UNSUPPORTED_SCHEMA errors"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "schemaNodes": 128,
            "schemaDepth": 12,
            "schemaProperties": 64,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128,
                    "pattern": "^[A-Za-z0-9_.-]+$"
                  },
                  "description": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2048
                  },
                  "inputSchema": {
                    "$ref": "#/paths/~1v1~1x402~1json-schema-to-tool/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "outputSchema": {
                    "$ref": "#/paths/~1v1~1x402~1json-schema-to-tool/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "name",
                  "description",
                  "inputSchema"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-schema-to-tool/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-schema-to-tool/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "name": "get_order",
                "description": "Look up an order by its positive integer ID",
                "inputSchema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "minimum": 1
                    }
                  },
                  "required": [
                    "id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-schema-to-tool",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "typed-schema-subset-v1"
                        },
                        "descriptor": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "description": {
                              "type": "string"
                            },
                            "inputSchema": {
                              "$ref": "#/paths/~1v1~1x402~1json-schema-to-tool/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            },
                            "outputSchema": {
                              "$ref": "#/paths/~1v1~1x402~1json-schema-to-tool/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            }
                          },
                          "required": [
                            "name",
                            "description",
                            "inputSchema"
                          ],
                          "additionalProperties": false
                        },
                        "warnings": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "descriptor",
                        "warnings"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-schema-to-tool/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-schema-to-tool/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-schema-to-tool",
                  "version": "0.29.0",
                  "result": {
                    "profile": "typed-schema-subset-v1",
                    "descriptor": {
                      "name": "get_order",
                      "description": "Look up an order by its positive integer ID",
                      "inputSchema": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "minimum": 1
                          }
                        },
                        "required": [
                          "id"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "warnings": [
                      "A descriptor is data, not an executable tool or a running MCP server",
                      "Tool descriptions are untrusted text; review before exposing to agents"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "278496984a5761d83ccfe31253b7c07535337ba0b112069638a70e90fea0da8c",
                    "outputSha256": "088217a6d0b8f139db4d12de1646e87f869a19e3d4eb8674c5b2be5d930d4a6e",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/mcp-tool-lint": {
      "post": {
        "operationId": "x402_mcp_tool_lint",
        "summary": "MCP Tool Descriptor Lint",
        "description": "Lint a supplied MCP tool descriptor for a bounded naming profile, description quality, object-root input/output schemas and typed annotation hints. Unsupported schemas produce explicit findings. Annotations are untrusted hints; this is neither full MCP protocol validation nor a security decision.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/mcp-tool-lint.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Review tool descriptors before adding them to an agent catalogue",
            "Identify schema limitations and untrusted annotation hints"
          ],
          "whenToUse": [
            "Review tool descriptors before adding them to an agent catalogue",
            "Identify schema limitations and untrusted annotation hints"
          ],
          "whenNotToUse": [
            "MCP transport/protocol conformance certification",
            "Trusting readOnlyHint as an authorization guarantee"
          ],
          "capabilities": [
            "Machine-actionable pointer findings",
            "128-character portable tool naming profile"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "schemaNodes": 128,
            "schemaDepth": 12,
            "schemaProperties": 64,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "tool": {
                    "$ref": "#/paths/~1v1~1x402~1mcp-tool-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "tool"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1mcp-tool-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1mcp-tool-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "tool": {
                  "name": "get_order",
                  "description": "Read a single order by ID",
                  "inputSchema": {
                    "type": "object",
                    "required": [
                      "id"
                    ],
                    "properties": {
                      "id": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": false
                  },
                  "annotations": {
                    "readOnlyHint": true,
                    "openWorldHint": false
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "mcp-tool-lint",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "mcp-tool-descriptor-lint-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "complete": {
                          "type": "boolean",
                          "const": false
                        },
                        "schemaSupported": {
                          "type": "boolean"
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "suggestion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "suggestion"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "complete",
                        "schemaSupported",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "mcp-tool-lint",
                  "version": "0.29.0",
                  "result": {
                    "profile": "mcp-tool-descriptor-lint-v1",
                    "passesChecks": true,
                    "complete": false,
                    "schemaSupported": true,
                    "findings": [
                      {
                        "code": "ANNOTATIONS_UNTRUSTED",
                        "severity": "warning",
                        "path": "/tool/annotations",
                        "message": "Annotations are hints and cannot establish authorization or safety",
                        "suggestion": "Verify tool behavior and enforce permissions independently"
                      }
                    ],
                    "findingCount": 1,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "f66182b11adf2e7a4e3a849f0df9edd8d3045eae4ccea501d2b2e9a7d491f31c",
                    "outputSha256": "6c4e2538aeec9993abca6cba4ccddc9e47a5a1a7f2e4836c55d4ff5380d13ce2",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/openapi-request-check": {
      "post": {
        "operationId": "x402_openapi_request_check",
        "summary": "OpenAPI Request Preflight",
        "description": "Check already-deserialized supplied parameter values and an optional JSON body against one exact OpenAPI 3.1 path-template/method. Applies the typed-schema subset only; references, serialization, authentication, parameter content and non-JSON bodies are not evaluated. Reports unsupported coverage separately from invalid values; never sends the request.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/openapi-request-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Preflight a typed API request before paying for or executing it",
            "Find missing required parameters and incompatible JSON bodies"
          ],
          "whenToUse": [
            "Preflight a typed API request before paying for or executing it",
            "Find missing required parameters and incompatible JSON bodies"
          ],
          "whenNotToUse": [
            "Validating raw URL encoding, serialization, auth or live behavior",
            "Resolving OpenAPI references or arbitrary JSON Schema"
          ],
          "capabilities": [
            "Exact method and path-template selection",
            "Case-insensitive supplied headers; no coercion; unsupported coverage yields valid null"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "paths": 100,
            "operations": 200,
            "effectiveParameters": 100,
            "schemaNodes": 128,
            "schemaDepth": 12,
            "schemaProperties": 64,
            "evaluations": 50000,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1x402~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "path": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "get",
                      "put",
                      "post",
                      "delete",
                      "options",
                      "head",
                      "patch",
                      "trace"
                    ]
                  },
                  "parameters": {
                    "default": {},
                    "type": "object",
                    "properties": {
                      "path": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "query": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "header": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "cookie": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    },
                    "additionalProperties": false
                  },
                  "body": {
                    "$ref": "#/paths/~1v1~1x402~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "document",
                  "path",
                  "method"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "openapi": "3.1.0",
                  "info": {
                    "title": "Orders",
                    "version": "1.0.0"
                  },
                  "paths": {
                    "/orders/{id}": {
                      "get": {
                        "operationId": "getOrder",
                        "summary": "Read one order",
                        "parameters": [
                          {
                            "name": "id",
                            "in": "path",
                            "required": true,
                            "schema": {
                              "type": "integer",
                              "minimum": 1
                            }
                          }
                        ],
                        "responses": {
                          "200": {
                            "description": "Order"
                          }
                        }
                      }
                    }
                  }
                },
                "path": "/orders/{id}",
                "method": "get",
                "parameters": {
                  "path": {
                    "id": 7
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "openapi-request-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "openapi-deserialized-request-subset-v1"
                        },
                        "supported": {
                          "type": "boolean"
                        },
                        "valid": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "checkedValues": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "suggestion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "suggestion"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "supported",
                        "valid",
                        "checkedValues",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "openapi-request-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "openapi-deserialized-request-subset-v1",
                    "supported": true,
                    "valid": true,
                    "checkedValues": 1,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "7c5e745808fc3f1d280011987900f177671819c8881581432eb3a5a0654de254",
                    "outputSha256": "28f2aa7115986471ad8bcbdf90d6db4708b426b1eccf2ac7658678e89cdf3280",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/package-url-inspect": {
      "post": {
        "operationId": "x402_package_url_inspect",
        "summary": "Package URL Inspect",
        "description": "Parse a bounded Package URL and normalize generic syntax: type/qualifier case, percent encoding, qualifier order. Preserves name/version case; no ecosystem rules or registry validation. Strict subset rejects empty/dot path segments, whitespace, raw reserved characters, malformed UTF-8, and duplicate qualifiers.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/package-url-inspect.md"
        },
        "x-agent-discovery": {
          "intents": [
            "parse package URL",
            "normalize PURL syntax",
            "inspect package coordinates"
          ],
          "whenToUse": [
            "Extract package type, namespace, version, qualifiers, and subpath without network access",
            "Normalize percent escapes and qualifier ordering inside the advertised subset"
          ],
          "whenNotToUse": [
            "Full ECMA-427 or ecosystem-specific PURL validation/canonicalization",
            "Registry existence checks or fetching package artifacts"
          ],
          "capabilities": [
            "Generic syntax profile with explicit ecosystemRulesApplied=false",
            "Sorted unique qualifier keys; UTF-8 decoding; no fetch"
          ],
          "related": [
            "sbom-inventory",
            "sbom-diff"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "purlCharacters": 4096,
            "namespaceSegments": 32,
            "qualifiers": 32,
            "subpathSegments": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "INVALID_PURL"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "purl": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4096
                  }
                },
                "required": [
                  "purl"
                ],
                "additionalProperties": false
              },
              "example": {
                "purl": "pkg:npm/%40acme/worker-kit@1.2.0?repository_url=https%3A%2F%2Fregistry.example&arch=x64#dist/index.js"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "package-url-inspect",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "normalized": {
                          "type": "string",
                          "maxLength": 12288
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "namespace": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 2048
                          }
                        },
                        "name": {
                          "type": "string",
                          "maxLength": 2048
                        },
                        "version": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 2048
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "qualifiers": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 2048
                              }
                            },
                            "required": [
                              "key",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "subpath": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 2048
                          }
                        },
                        "profile": {
                          "type": "string",
                          "const": "generic-syntax-subset-v1"
                        },
                        "ecosystemRulesApplied": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "normalized",
                        "type",
                        "namespace",
                        "name",
                        "version",
                        "qualifiers",
                        "subpath",
                        "profile",
                        "ecosystemRulesApplied"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "package-url-inspect",
                  "version": "0.29.0",
                  "result": {
                    "normalized": "pkg:npm/%40acme/worker-kit@1.2.0?arch=x64&repository_url=https%3A%2F%2Fregistry.example#dist/index.js",
                    "type": "npm",
                    "namespace": [
                      "@acme"
                    ],
                    "name": "worker-kit",
                    "version": "1.2.0",
                    "qualifiers": [
                      {
                        "key": "arch",
                        "value": "x64"
                      },
                      {
                        "key": "repository_url",
                        "value": "https://registry.example"
                      }
                    ],
                    "subpath": [
                      "dist",
                      "index.js"
                    ],
                    "profile": "generic-syntax-subset-v1",
                    "ecosystemRulesApplied": false
                  },
                  "provenance": {
                    "inputSha256": "5c4dfe4d67dbd3df697be9f5119fee7da589fd2f05cf0bf7ea10c6b860c04659",
                    "outputSha256": "99448916979697e5c9fff32ebdecee9d452e113f95e03134503022f51e86aca1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/sbom-inventory": {
      "post": {
        "operationId": "x402_sbom_inventory",
        "summary": "SBOM Inventory",
        "description": "Extract names, versions, PURLs, declared licenses and hashes from CycloneDX JSON 1.5/1.6 or SPDX JSON 2.3. Includes nested CycloneDX components and metadata.component; excludes services, external BOMs, relationships and unconsumed fields. No full document, license, PURL or hash validation.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/sbom-inventory.md"
        },
        "x-agent-discovery": {
          "intents": [
            "extract SBOM inventory",
            "extract component names, versions and licenses from a software bill of materials",
            "read CycloneDX components",
            "read SPDX packages"
          ],
          "whenToUse": [
            "Build a small auditable component inventory from caller-supplied SBOM JSON",
            "Retain source JSON pointers and distinguish declared/concluded license fields"
          ],
          "whenNotToUse": [
            "Full SBOM conformance checks, dependency resolution or vulnerability scanning",
            "XML/tag-value inputs, external document traversal or artifact verification"
          ],
          "capabilities": [
            "CycloneDX 1.5 and 1.6 JSON, SPDX 2.3 JSON",
            "Nested components, metadata root, normalized license/hash lists and source pointers",
            "Unknown fields ignored; consumed fields strictly type-checked"
          ],
          "related": [
            "sbom-diff",
            "package-url-inspect",
            "spdx-expression-analyze"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "components": 500,
            "licensesPerComponent": 16,
            "hashesPerComponent": 16,
            "spdxExternalRefsPerPackage": 64
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "INVALID_DOCUMENT",
            "UNSUPPORTED_SBOM",
            "AMBIGUOUS_COMPONENT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {},
                    "description": "JSON document: at most 100,000 UTF-8 serialized bytes per request, 12,000 nodes and 24 levels; consumed fields are type-checked; unconsumed fields are ignored, not standards-validated."
                  }
                },
                "required": [
                  "document"
                ],
                "additionalProperties": false
              },
              "example": {
                "document": {
                  "bomFormat": "CycloneDX",
                  "specVersion": "1.6",
                  "components": [
                    {
                      "type": "library",
                      "name": "worker-kit",
                      "version": "1.2.0",
                      "purl": "pkg:npm/worker-kit@1.2.0",
                      "licenses": [
                        {
                          "license": {
                            "id": "MIT"
                          }
                        }
                      ]
                    }
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "sbom-inventory",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "format": {
                          "type": "string",
                          "enum": [
                            "CycloneDX",
                            "SPDX"
                          ]
                        },
                        "specVersion": {
                          "type": "string",
                          "enum": [
                            "1.5",
                            "1.6",
                            "2.3"
                          ]
                        },
                        "componentCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 500
                        },
                        "components": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "sourcePointer": {
                                "type": "string",
                                "maxLength": 4096
                              },
                              "reference": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string",
                                "maxLength": 2048
                              },
                              "group": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "version": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "purl": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 4096
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "type": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "licenses": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "enum": [
                                        "id",
                                        "name",
                                        "expression",
                                        "declared",
                                        "concluded"
                                      ]
                                    },
                                    "value": {
                                      "type": "string",
                                      "maxLength": 2048
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "hashes": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "algorithm": {
                                      "type": "string",
                                      "maxLength": 100
                                    },
                                    "value": {
                                      "type": "string",
                                      "maxLength": 2048
                                    }
                                  },
                                  "required": [
                                    "algorithm",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "sourcePointer",
                              "reference",
                              "name",
                              "group",
                              "version",
                              "purl",
                              "type",
                              "licenses",
                              "hashes"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "scope": {
                          "type": "string",
                          "const": "Extracted fields only; not full SBOM validation, dependency resolution, vulnerability scanning, or license compliance advice."
                        }
                      },
                      "required": [
                        "format",
                        "specVersion",
                        "componentCount",
                        "components",
                        "scope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "sbom-inventory",
                  "version": "0.29.0",
                  "result": {
                    "format": "CycloneDX",
                    "specVersion": "1.6",
                    "componentCount": 1,
                    "components": [
                      {
                        "sourcePointer": "/components/0",
                        "reference": null,
                        "name": "worker-kit",
                        "group": null,
                        "version": "1.2.0",
                        "purl": "pkg:npm/worker-kit@1.2.0",
                        "type": "library",
                        "licenses": [
                          {
                            "kind": "id",
                            "value": "MIT"
                          }
                        ],
                        "hashes": []
                      }
                    ],
                    "scope": "Extracted fields only; not full SBOM validation, dependency resolution, vulnerability scanning, or license compliance advice."
                  },
                  "provenance": {
                    "inputSha256": "80931d8b46b2cd7402b3eb7dedc67a8372ac5684a142e1ebfa31493d5b89c3fc",
                    "outputSha256": "7e9c092e6244e94d15ec23a34c2caa1ee002055ee1038c47c42ec09cd231c2b7",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/sbom-diff": {
      "post": {
        "operationId": "x402_sbom_diff",
        "summary": "SBOM Diff",
        "description": "Compare two supported SBOMs by unique exact group/name (default) or versionless generic-PURL identity. Report added/removed components and version/license/hash/PURL/type changes. Duplicate identities are rejected rather than cross-paired. Reference IDs and source positions are ignored; license comparison is textual, not semantic.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/sbom-diff.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compare SBOM releases",
            "compare software bills of materials for added, removed and changed components",
            "detect component version changes",
            "review declared license changes"
          ],
          "whenToUse": [
            "Review deterministic component changes between two caller-supplied SBOMs",
            "Reject ambiguous duplicates instead of inventing version matches"
          ],
          "whenNotToUse": [
            "License equivalence, transitive graph impact or vulnerability analysis",
            "Inventing matches across renamed packages, ecosystems or duplicate identities"
          ],
          "capabilities": [
            "Name/group or versionless PURL matching",
            "Stable sorted change reports; bounded map lookup rather than pairwise joins",
            "Cross-format comparisons preserve declared versus concluded license distinctions"
          ],
          "related": [
            "sbom-inventory",
            "package-url-inspect",
            "dependency-risk-flags"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "componentsPerDocument": 500,
            "inputBytesSharedAcrossBothDocuments": 100000
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "INVALID_DOCUMENT",
            "UNSUPPORTED_SBOM",
            "AMBIGUOUS_COMPONENT",
            "MISSING_PURL",
            "INVALID_PURL"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "before": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {},
                    "description": "JSON document: at most 100,000 UTF-8 serialized bytes per request, 12,000 nodes and 24 levels; consumed fields are type-checked; unconsumed fields are ignored, not standards-validated."
                  },
                  "after": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {},
                    "description": "JSON document: at most 100,000 UTF-8 serialized bytes per request, 12,000 nodes and 24 levels; consumed fields are type-checked; unconsumed fields are ignored, not standards-validated."
                  },
                  "matchBy": {
                    "default": "name",
                    "type": "string",
                    "enum": [
                      "name",
                      "purl"
                    ]
                  }
                },
                "required": [
                  "before",
                  "after"
                ],
                "additionalProperties": false
              },
              "example": {
                "before": {
                  "bomFormat": "CycloneDX",
                  "specVersion": "1.6",
                  "components": [
                    {
                      "type": "library",
                      "name": "worker-kit",
                      "version": "1.2.0",
                      "purl": "pkg:npm/worker-kit@1.2.0",
                      "licenses": [
                        {
                          "license": {
                            "id": "MIT"
                          }
                        }
                      ]
                    }
                  ]
                },
                "after": {
                  "bomFormat": "CycloneDX",
                  "specVersion": "1.6",
                  "components": [
                    {
                      "type": "library",
                      "name": "worker-kit",
                      "version": "1.3.0",
                      "purl": "pkg:npm/worker-kit@1.3.0",
                      "licenses": [
                        {
                          "license": {
                            "id": "MIT"
                          }
                        }
                      ]
                    }
                  ]
                },
                "matchBy": "name"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "sbom-diff",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "matchBy": {
                          "type": "string",
                          "enum": [
                            "name",
                            "purl"
                          ]
                        },
                        "added": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "identity": {
                                "type": "string",
                                "maxLength": 12288
                              },
                              "component": {
                                "type": "object",
                                "properties": {
                                  "sourcePointer": {
                                    "type": "string",
                                    "maxLength": 4096
                                  },
                                  "reference": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "group": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "version": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "purl": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 4096
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "type": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "licenses": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "id",
                                            "name",
                                            "expression",
                                            "declared",
                                            "concluded"
                                          ]
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  "hashes": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "algorithm": {
                                          "type": "string",
                                          "maxLength": 100
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "algorithm",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "sourcePointer",
                                  "reference",
                                  "name",
                                  "group",
                                  "version",
                                  "purl",
                                  "type",
                                  "licenses",
                                  "hashes"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "identity",
                              "component"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "removed": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "identity": {
                                "type": "string",
                                "maxLength": 12288
                              },
                              "component": {
                                "type": "object",
                                "properties": {
                                  "sourcePointer": {
                                    "type": "string",
                                    "maxLength": 4096
                                  },
                                  "reference": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "group": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "version": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "purl": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 4096
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "type": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "licenses": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "id",
                                            "name",
                                            "expression",
                                            "declared",
                                            "concluded"
                                          ]
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  "hashes": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "algorithm": {
                                          "type": "string",
                                          "maxLength": 100
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "algorithm",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "sourcePointer",
                                  "reference",
                                  "name",
                                  "group",
                                  "version",
                                  "purl",
                                  "type",
                                  "licenses",
                                  "hashes"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "identity",
                              "component"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "changed": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "identity": {
                                "type": "string",
                                "maxLength": 12288
                              },
                              "fields": {
                                "maxItems": 5,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "version",
                                    "licenses",
                                    "hashes",
                                    "purl",
                                    "type"
                                  ]
                                }
                              },
                              "before": {
                                "type": "object",
                                "properties": {
                                  "sourcePointer": {
                                    "type": "string",
                                    "maxLength": 4096
                                  },
                                  "reference": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "group": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "version": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "purl": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 4096
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "type": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "licenses": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "id",
                                            "name",
                                            "expression",
                                            "declared",
                                            "concluded"
                                          ]
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  "hashes": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "algorithm": {
                                          "type": "string",
                                          "maxLength": 100
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "algorithm",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "sourcePointer",
                                  "reference",
                                  "name",
                                  "group",
                                  "version",
                                  "purl",
                                  "type",
                                  "licenses",
                                  "hashes"
                                ],
                                "additionalProperties": false
                              },
                              "after": {
                                "type": "object",
                                "properties": {
                                  "sourcePointer": {
                                    "type": "string",
                                    "maxLength": 4096
                                  },
                                  "reference": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "group": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "version": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "purl": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 4096
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "type": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "licenses": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "id",
                                            "name",
                                            "expression",
                                            "declared",
                                            "concluded"
                                          ]
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  "hashes": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "algorithm": {
                                          "type": "string",
                                          "maxLength": 100
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "algorithm",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "sourcePointer",
                                  "reference",
                                  "name",
                                  "group",
                                  "version",
                                  "purl",
                                  "type",
                                  "licenses",
                                  "hashes"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "identity",
                              "fields",
                              "before",
                              "after"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "unchangedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 500
                        },
                        "scope": {
                          "type": "string",
                          "const": "Unique group/name or versionless generic-PURL identities only; reference IDs, ordering, and source positions are ignored. Duplicate identities are rejected, not guessed."
                        }
                      },
                      "required": [
                        "matchBy",
                        "added",
                        "removed",
                        "changed",
                        "unchangedCount",
                        "scope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "sbom-diff",
                  "version": "0.29.0",
                  "result": {
                    "matchBy": "name",
                    "added": [],
                    "removed": [],
                    "changed": [
                      {
                        "identity": "[null,\"worker-kit\"]",
                        "fields": [
                          "version",
                          "purl"
                        ],
                        "before": {
                          "sourcePointer": "/components/0",
                          "reference": null,
                          "name": "worker-kit",
                          "group": null,
                          "version": "1.2.0",
                          "purl": "pkg:npm/worker-kit@1.2.0",
                          "type": "library",
                          "licenses": [
                            {
                              "kind": "id",
                              "value": "MIT"
                            }
                          ],
                          "hashes": []
                        },
                        "after": {
                          "sourcePointer": "/components/0",
                          "reference": null,
                          "name": "worker-kit",
                          "group": null,
                          "version": "1.3.0",
                          "purl": "pkg:npm/worker-kit@1.3.0",
                          "type": "library",
                          "licenses": [
                            {
                              "kind": "id",
                              "value": "MIT"
                            }
                          ],
                          "hashes": []
                        }
                      }
                    ],
                    "unchangedCount": 0,
                    "scope": "Unique group/name or versionless generic-PURL identities only; reference IDs, ordering, and source positions are ignored. Duplicate identities are rejected, not guessed."
                  },
                  "provenance": {
                    "inputSha256": "b19944d599f94ec8f81c15402bd893787a4e4bbb2eb0f5ae646264db8b31b8b2",
                    "outputSha256": "d267cc8407c56c634f70b48cbbdd55534cbeb8ea0c293a8e92a61b1b9e3e31d6",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/lockfile-inventory": {
      "post": {
        "operationId": "x402_lockfile_inventory",
        "summary": "Lockfile Inventory",
        "description": "Extract npm package-lock v2/v3 packages by sorted location, retaining versions, resolved sources, integrity/license strings and dev/optional/devOptional/link/install-script flags. No package installation, graph resolution or hash verification. Workspace names require a declared name; node_modules names can be inferred from location.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/lockfile-inventory.md"
        },
        "x-agent-discovery": {
          "intents": [
            "inventory npm lockfile",
            "extract package-lock dependencies",
            "inspect lockfile integrity metadata"
          ],
          "whenToUse": [
            "Read package locations and declared metadata without installing anything",
            "Retain nested copies and workspace links as separate locations"
          ],
          "whenNotToUse": [
            "npm v1, Yarn, pnpm, Poetry or Cargo lockfiles",
            "Transitive dependency graph resolution, artifact retrieval or installation verification"
          ],
          "capabilities": [
            "npm package-lock v2/v3 packages table",
            "Explicit root toggle; sorted location rows; false for omitted boolean flags",
            "Links reported without following targets; legacy dependencies table ignored"
          ],
          "related": [
            "dependency-risk-flags",
            "sbom-inventory"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "packageLocationsIncludingRoot": 500,
            "locationCharacters": 1024
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "INVALID_DOCUMENT",
            "UNSUPPORTED_LOCKFILE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {},
                    "description": "JSON document: at most 100,000 UTF-8 serialized bytes per request, 12,000 nodes and 24 levels; consumed fields are type-checked; unconsumed fields are ignored, not standards-validated."
                  },
                  "includeRoot": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "document"
                ],
                "additionalProperties": false
              },
              "example": {
                "document": {
                  "name": "edge-worker",
                  "lockfileVersion": 3,
                  "packages": {
                    "": {
                      "name": "edge-worker",
                      "version": "1.0.0"
                    },
                    "node_modules/worker-kit": {
                      "version": "1.2.0",
                      "resolved": "https://registry.example/worker-kit-1.2.0.tgz",
                      "license": "MIT",
                      "dev": true
                    }
                  }
                },
                "includeRoot": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "lockfile-inventory",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "lockfileVersion": {
                          "anyOf": [
                            {
                              "type": "number",
                              "const": 2
                            },
                            {
                              "type": "number",
                              "const": 3
                            }
                          ]
                        },
                        "packageCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 500
                        },
                        "packages": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "location": {
                                "type": "string",
                                "maxLength": 1024
                              },
                              "name": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "version": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "resolved": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "integrity": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "license": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "dev": {
                                "type": "boolean"
                              },
                              "optional": {
                                "type": "boolean"
                              },
                              "devOptional": {
                                "type": "boolean"
                              },
                              "link": {
                                "type": "boolean"
                              },
                              "inBundle": {
                                "type": "boolean"
                              },
                              "hasInstallScript": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "location",
                              "name",
                              "version",
                              "resolved",
                              "integrity",
                              "license",
                              "dev",
                              "optional",
                              "devOptional",
                              "link",
                              "inBundle",
                              "hasInstallScript"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "scope": {
                          "type": "string",
                          "const": "npm package-lock v2/v3 packages table only; legacy dependencies ignored; absent boolean flags are false; link targets are not followed and hashes are not verified."
                        }
                      },
                      "required": [
                        "lockfileVersion",
                        "packageCount",
                        "packages",
                        "scope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "lockfile-inventory",
                  "version": "0.29.0",
                  "result": {
                    "lockfileVersion": 3,
                    "packageCount": 1,
                    "packages": [
                      {
                        "location": "node_modules/worker-kit",
                        "name": "worker-kit",
                        "version": "1.2.0",
                        "resolved": "https://registry.example/worker-kit-1.2.0.tgz",
                        "integrity": null,
                        "license": "MIT",
                        "dev": true,
                        "optional": false,
                        "devOptional": false,
                        "link": false,
                        "inBundle": false,
                        "hasInstallScript": false
                      }
                    ],
                    "scope": "npm package-lock v2/v3 packages table only; legacy dependencies ignored; absent boolean flags are false; link targets are not followed and hashes are not verified."
                  },
                  "provenance": {
                    "inputSha256": "44372e18b4f1fb63575b3659833ee08607dc747c5e42deb3df735da0985fee80",
                    "outputSha256": "b0104ed8c8a474575b7c231e15b166b1022bb87eb42a3f8e18782794e5e86b31",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/dependency-risk-flags": {
      "post": {
        "operationId": "x402_dependency_risk_flags",
        "summary": "Dependency Metadata Flags",
        "description": "Flag declared npm-style metadata gaps: missing/non-exact canonical SemVer pins, missing/insecure/local/unrecognized sources, missing/malformed or SHA1-only integrity, and missing license markers. Syntax/presence heuristics only; no vulnerability database, artifact verification, trust score or legal conclusion.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/dependency-risk-flags.md"
        },
        "x-agent-discovery": {
          "intents": [
            "flag dependency metadata gaps",
            "find unpinned npm specifiers",
            "check declared integrity syntax"
          ],
          "whenToUse": [
            "Triage a bounded declared dependency list before human policy review",
            "Find missing pins, source declarations, integrity strings and license metadata"
          ],
          "whenNotToUse": [
            "Vulnerability or malware scanning, security certification, license compatibility decisions",
            "Treating absent flags as evidence a dependency is safe or authentic"
          ],
          "capabilities": [
            "Canonical SemVer exact-pin check; ranges, tags and git pins flagged as non-exact SemVer",
            "Canonical padded base64 SRI subset: SHA1/SHA256/SHA384/SHA512, at most 16 digests",
            "No fetch, hash verification, registry query or aggregate risk score"
          ],
          "related": [
            "lockfile-inventory",
            "spdx-expression-analyze",
            "semver-evaluate"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "dependencies": 500,
            "specifierCharacters": 256,
            "integrityDigests": 16
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "dependencies": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256
                        },
                        "specifier": {
                          "type": "string",
                          "maxLength": 256
                        },
                        "source": {
                          "type": "string",
                          "maxLength": 2048
                        },
                        "integrity": {
                          "type": "string",
                          "maxLength": 2048
                        },
                        "license": {
                          "type": "string",
                          "maxLength": 2048
                        }
                      },
                      "required": [
                        "name"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "dependencies"
                ],
                "additionalProperties": false
              },
              "example": {
                "dependencies": [
                  {
                    "name": "worker-kit",
                    "specifier": "^1.2.0",
                    "source": "http://registry.example/worker-kit.tgz",
                    "license": "NOASSERTION"
                  },
                  {
                    "name": "private-plugin",
                    "specifier": "2.0.0",
                    "source": "file:../private-plugin",
                    "license": "UNLICENSED"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "dependency-risk-flags",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "dependencyCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 500
                        },
                        "flaggedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 500
                        },
                        "dependencies": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 499
                              },
                              "name": {
                                "type": "string",
                                "maxLength": 256
                              },
                              "flags": {
                                "maxItems": 11,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "MISSING_SPECIFIER",
                                    "NON_EXACT_SEMVER",
                                    "MISSING_SOURCE",
                                    "INSECURE_SOURCE",
                                    "LOCAL_SOURCE",
                                    "UNRECOGNIZED_SOURCE",
                                    "MISSING_INTEGRITY",
                                    "MALFORMED_INTEGRITY",
                                    "SHA1_INTEGRITY_ONLY",
                                    "MISSING_LICENSE",
                                    "LICENSE_MARKER"
                                  ]
                                }
                              }
                            },
                            "required": [
                              "index",
                              "name",
                              "flags"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "scope": {
                          "type": "string",
                          "const": "Declared npm-style metadata checks only. Exact pin means canonical SemVer; integrity is syntax-checked, never verified against bytes. Flags are not vulnerabilities, trust scores, license advice, or security certification."
                        }
                      },
                      "required": [
                        "dependencyCount",
                        "flaggedCount",
                        "dependencies",
                        "scope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "dependency-risk-flags",
                  "version": "0.29.0",
                  "result": {
                    "dependencyCount": 2,
                    "flaggedCount": 2,
                    "dependencies": [
                      {
                        "index": 0,
                        "name": "worker-kit",
                        "flags": [
                          "NON_EXACT_SEMVER",
                          "INSECURE_SOURCE",
                          "MISSING_INTEGRITY",
                          "MISSING_LICENSE"
                        ]
                      },
                      {
                        "index": 1,
                        "name": "private-plugin",
                        "flags": [
                          "LOCAL_SOURCE",
                          "MISSING_INTEGRITY",
                          "LICENSE_MARKER"
                        ]
                      }
                    ],
                    "scope": "Declared npm-style metadata checks only. Exact pin means canonical SemVer; integrity is syntax-checked, never verified against bytes. Flags are not vulnerabilities, trust scores, license advice, or security certification."
                  },
                  "provenance": {
                    "inputSha256": "be895ca312990c168698ad23c01ab6760d8418b98486095625f41e3878f83b5e",
                    "outputSha256": "e688f33b9caae1165e9f447518bd5bf579033cb1748934c640d652ee9080234b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/spdx-expression-analyze": {
      "post": {
        "operationId": "x402_spdx_expression_analyze",
        "summary": "SPDX Expression Analyze",
        "description": "Parse bounded SPDX-style license expression syntax into a flat indexed AST, unique identifiers/exceptions and fully parenthesized normalization. Supports AND/OR/WITH, +, LicenseRef and DocumentRef; enforces precedence and simple-left WITH. Does not validate current license/exception lists or give compliance advice; NONE/NOASSERTION document markers are rejected.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/spdx-expression-analyze.md"
        },
        "x-agent-discovery": {
          "intents": [
            "parse SPDX license expression",
            "inspect license expression AST",
            "normalize SPDX expression syntax"
          ],
          "whenToUse": [
            "Inspect operator precedence and identifier references in a supplied expression",
            "Perform bounded syntax preparation before a separate policy or license-list check"
          ],
          "whenNotToUse": [
            "Proving identifiers are in the current SPDX list",
            "License compatibility, legal advice or boolean expansion of all license choices"
          ],
          "capabilities": [
            "WITH before AND before OR; case-sensitive operators",
            "Flat postorder indexed AST avoids recursive output amplification",
            "ASCII spaces/tabs only; plus attaches directly to a non-reference identifier"
          ],
          "related": [
            "sbom-inventory",
            "dependency-risk-flags"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "expressionCharacters": 4096,
            "tokens": 255,
            "astNodes": 255,
            "parenthesisLevels": 16
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "INVALID_SPDX_EXPRESSION"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "expression": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4096
                  }
                },
                "required": [
                  "expression"
                ],
                "additionalProperties": false
              },
              "example": {
                "expression": "MIT OR Apache-2.0 AND GPL-2.0-only WITH Classpath-exception-2.0"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "spdx-expression-analyze",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "syntaxValid": {
                          "type": "boolean",
                          "const": true
                        },
                        "normalized": {
                          "type": "string",
                          "maxLength": 8192
                        },
                        "root": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 254
                        },
                        "nodes": {
                          "minItems": 1,
                          "maxItems": 255,
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "license"
                                  },
                                  "identifier": {
                                    "type": "string",
                                    "maxLength": 256
                                  },
                                  "orLater": {
                                    "type": "boolean"
                                  },
                                  "customReference": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "kind",
                                  "identifier",
                                  "orLater",
                                  "customReference"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "with"
                                  },
                                  "license": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 254
                                  },
                                  "exception": {
                                    "type": "string",
                                    "maxLength": 128
                                  }
                                },
                                "required": [
                                  "kind",
                                  "license",
                                  "exception"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "enum": [
                                      "and",
                                      "or"
                                    ]
                                  },
                                  "left": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 254
                                  },
                                  "right": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 254
                                  }
                                },
                                "required": [
                                  "kind",
                                  "left",
                                  "right"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        },
                        "licenseIdentifiers": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 256
                          }
                        },
                        "exceptions": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 128
                          }
                        },
                        "scope": {
                          "type": "string",
                          "const": "SPDX 2.3 expression grammar subset with ASCII spaces/tabs, case-sensitive operators, LicenseRef and optional DocumentRef. Identifiers are not checked against a current SPDX list; no legal or compatibility conclusions."
                        }
                      },
                      "required": [
                        "syntaxValid",
                        "normalized",
                        "root",
                        "nodes",
                        "licenseIdentifiers",
                        "exceptions",
                        "scope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "spdx-expression-analyze",
                  "version": "0.29.0",
                  "result": {
                    "syntaxValid": true,
                    "normalized": "(MIT OR (Apache-2.0 AND GPL-2.0-only WITH Classpath-exception-2.0))",
                    "root": 5,
                    "nodes": [
                      {
                        "kind": "license",
                        "identifier": "MIT",
                        "orLater": false,
                        "customReference": false
                      },
                      {
                        "kind": "license",
                        "identifier": "Apache-2.0",
                        "orLater": false,
                        "customReference": false
                      },
                      {
                        "kind": "license",
                        "identifier": "GPL-2.0-only",
                        "orLater": false,
                        "customReference": false
                      },
                      {
                        "kind": "with",
                        "license": 2,
                        "exception": "Classpath-exception-2.0"
                      },
                      {
                        "kind": "and",
                        "left": 1,
                        "right": 3
                      },
                      {
                        "kind": "or",
                        "left": 0,
                        "right": 4
                      }
                    ],
                    "licenseIdentifiers": [
                      "Apache-2.0",
                      "GPL-2.0-only",
                      "MIT"
                    ],
                    "exceptions": [
                      "Classpath-exception-2.0"
                    ],
                    "scope": "SPDX 2.3 expression grammar subset with ASCII spaces/tabs, case-sensitive operators, LicenseRef and optional DocumentRef. Identifiers are not checked against a current SPDX list; no legal or compatibility conclusions."
                  },
                  "provenance": {
                    "inputSha256": "2d769c525513182591de214bb176bf06aed5e0544a40aa706ec0920311cca573",
                    "outputSha256": "32c66e480aa54016a4e908e59960671718f6afa5c0f95e16ae75ac708b083cd2",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/workflow-dag-analyze": {
      "post": {
        "operationId": "x402_workflow_dag_analyze",
        "summary": "Workflow Dependency Analysis",
        "description": "Find missing dependencies and cyclic components; derive stable parallel layers, critical path, earliest/latest timings and slack from a supplied task graph. Caller-estimated integer durations and unlimited parallel workers only; never executes tasks.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/workflow-dag-analyze.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find cycles and missing dependencies in an agent task DAG",
            "Plan parallel execution stages and estimate a workflow critical path"
          ],
          "whenToUse": [
            "Find cycles and missing dependencies in an agent task DAG",
            "Plan parallel execution stages and estimate a workflow critical path"
          ],
          "whenNotToUse": [
            "Resource-constrained scheduling or runtime prediction guarantees",
            "Executing, authorizing, or monitoring agent work"
          ],
          "capabilities": [
            "Actual cyclic components separated from blocked downstream tasks",
            "Stable topological layers and critical-path slack"
          ],
          "related": [
            "workflow-transition-check",
            "retry-schedule-plan"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "tasks": 100,
            "dependencyEdges": 1000,
            "durationMsPerTask": 86400000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "tasks": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "dependsOn": {
                          "default": [],
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 80
                          }
                        },
                        "durationMs": {
                          "default": 0,
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 86400000
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "tasks"
                ],
                "additionalProperties": false
              },
              "example": {
                "tasks": [
                  {
                    "id": "fetch",
                    "durationMs": 100
                  },
                  {
                    "id": "summarize",
                    "dependsOn": [
                      "fetch"
                    ],
                    "durationMs": 300
                  },
                  {
                    "id": "index",
                    "dependsOn": [
                      "fetch"
                    ],
                    "durationMs": 200
                  },
                  {
                    "id": "publish",
                    "dependsOn": [
                      "summarize",
                      "index"
                    ],
                    "durationMs": 50
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "workflow-dag-analyze",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "workflow-dag-v1"
                        },
                        "schedulable": {
                          "type": "boolean"
                        },
                        "topologicalOrder": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "layers": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "cycles": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "unresolvedTaskIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "criticalPath": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "makespanMs": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "timing": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "earliestStartMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "earliestFinishMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "latestStartMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "slackMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "id",
                              "earliestStartMs",
                              "earliestFinishMs",
                              "latestStartMs",
                              "slackMs"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "assumptions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "schedulable",
                        "topologicalOrder",
                        "layers",
                        "cycles",
                        "unresolvedTaskIds",
                        "criticalPath",
                        "makespanMs",
                        "timing",
                        "assumptions",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "workflow-dag-analyze",
                  "version": "0.29.0",
                  "result": {
                    "profile": "workflow-dag-v1",
                    "schedulable": true,
                    "topologicalOrder": [
                      "fetch",
                      "index",
                      "summarize",
                      "publish"
                    ],
                    "layers": [
                      [
                        "fetch"
                      ],
                      [
                        "index",
                        "summarize"
                      ],
                      [
                        "publish"
                      ]
                    ],
                    "cycles": [],
                    "unresolvedTaskIds": [],
                    "criticalPath": [
                      "fetch",
                      "summarize",
                      "publish"
                    ],
                    "makespanMs": 450,
                    "timing": [
                      {
                        "id": "fetch",
                        "earliestStartMs": 0,
                        "earliestFinishMs": 100,
                        "latestStartMs": 0,
                        "slackMs": 0
                      },
                      {
                        "id": "index",
                        "earliestStartMs": 100,
                        "earliestFinishMs": 300,
                        "latestStartMs": 200,
                        "slackMs": 100
                      },
                      {
                        "id": "publish",
                        "earliestStartMs": 400,
                        "earliestFinishMs": 450,
                        "latestStartMs": 400,
                        "slackMs": 0
                      },
                      {
                        "id": "summarize",
                        "earliestStartMs": 100,
                        "earliestFinishMs": 400,
                        "latestStartMs": 100,
                        "slackMs": 0
                      }
                    ],
                    "assumptions": [
                      "Durations are caller estimates in integer milliseconds",
                      "Unlimited parallel workers; no resource, retry, or network-time model"
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "654c113aff490cf72c0ff1c9957cfdfa5f2471cd0437e341e58f2eb81483c0fc",
                    "outputSha256": "4079a937ef3a0f4766cb2c0b1319139fc1cb87d4c90150b9a422db21b9e53df9",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/workflow-transition-check": {
      "post": {
        "operationId": "x402_workflow_transition_check",
        "summary": "Workflow State Trace Check",
        "description": "Validate a declared deterministic state machine and replay a supplied event trace. Reports ambiguous transitions, unreachable states, first impossible event, expected-state mismatches and final acceptance. No executable guards, actions, or authorization decisions.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/workflow-transition-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Audit an agent workflow event trace against allowed state transitions",
            "Find impossible transitions and incomplete terminal workflow states"
          ],
          "whenToUse": [
            "Audit an agent workflow event trace against allowed state transitions",
            "Find impossible transitions and incomplete terminal workflow states"
          ],
          "whenNotToUse": [
            "Formal verification of arbitrary programs or hidden state",
            "Interpreting natural-language policy or granting real-world permissions"
          ],
          "capabilities": [
            "Stops derivation at the first undefined transition",
            "Accepting-state checks and exact trace evidence"
          ],
          "related": [
            "workflow-dag-analyze",
            "jsonrpc-exchange-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "states": 100,
            "transitions": 500,
            "events": 500
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "states": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    }
                  },
                  "initialState": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80
                  },
                  "acceptingStates": {
                    "default": [],
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    }
                  },
                  "requireAccepting": {
                    "default": false,
                    "type": "boolean"
                  },
                  "transitions": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "from": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "event": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "to": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "from",
                        "event",
                        "to"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "events": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "event": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "expectedState": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "event"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "states",
                  "initialState",
                  "transitions",
                  "events"
                ],
                "additionalProperties": false
              },
              "example": {
                "states": [
                  "new",
                  "running",
                  "done"
                ],
                "initialState": "new",
                "acceptingStates": [
                  "done"
                ],
                "requireAccepting": true,
                "transitions": [
                  {
                    "from": "new",
                    "event": "start",
                    "to": "running"
                  },
                  {
                    "from": "running",
                    "event": "finish",
                    "to": "done"
                  }
                ],
                "events": [
                  {
                    "event": "start"
                  },
                  {
                    "event": "finish",
                    "expectedState": "done"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "workflow-transition-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "workflow-transition-v1"
                        },
                        "configurationValid": {
                          "type": "boolean"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "processedEvents": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "finalState": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "isAccepting": {
                          "type": "boolean"
                        },
                        "stoppedAt": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "unreachableStates": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "trace": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "event": {
                                "type": "string"
                              },
                              "from": {
                                "type": "string"
                              },
                              "to": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "index",
                              "event",
                              "from",
                              "to"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "configurationValid",
                        "passesChecks",
                        "processedEvents",
                        "finalState",
                        "isAccepting",
                        "stoppedAt",
                        "unreachableStates",
                        "trace",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "workflow-transition-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "workflow-transition-v1",
                    "configurationValid": true,
                    "passesChecks": true,
                    "processedEvents": 2,
                    "finalState": "done",
                    "isAccepting": true,
                    "stoppedAt": null,
                    "unreachableStates": [],
                    "trace": [
                      {
                        "index": 0,
                        "event": "start",
                        "from": "new",
                        "to": "running"
                      },
                      {
                        "index": 1,
                        "event": "finish",
                        "from": "running",
                        "to": "done"
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "31eb750355e55cbaa44cb491322c180f31ad4b141413227b57eac317027ffeca",
                    "outputSha256": "f35efb4f59d5483ad60b139bb108988686bf0090aeb91a3297754c4152753879",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/jsonrpc-exchange-check": {
      "post": {
        "operationId": "x402_jsonrpc_exchange_check",
        "summary": "JSON-RPC Exchange Check",
        "description": "Inspect supplied parsed JSON-RPC 2.0 requests/responses for envelope errors, notification replies, typed-ID collisions, missing responses and unmatched results. Bounded safe-integer-ID correlation profile; no transport, method execution, schema validation, or full interoperability certification.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/jsonrpc-exchange-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Correlate JSON-RPC batch replies with agent tool requests",
            "Detect missing tool responses, duplicate request IDs and replies to notifications"
          ],
          "whenToUse": [
            "Correlate JSON-RPC batch replies with agent tool requests",
            "Detect missing tool responses, duplicate request IDs and replies to notifications"
          ],
          "whenNotToUse": [
            "MCP lifecycle/authentication verification or tool invocation",
            "Raw JSON syntax validation or fractional/unsafe numeric ID correlation"
          ],
          "capabilities": [
            "String and numeric IDs remain distinct",
            "JSON-RPC source: https://www.jsonrpc.org/specification"
          ],
          "related": [
            "mcp-tool-lint",
            "workflow-transition-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "requestEnvelopes": 200,
            "responseEnvelopes": 200
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "request": {
                    "$ref": "#/paths/~1v1~1x402~1jsonrpc-exchange-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "response": {
                    "$ref": "#/paths/~1v1~1x402~1jsonrpc-exchange-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "request"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1jsonrpc-exchange-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1jsonrpc-exchange-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "request": [
                  {
                    "jsonrpc": "2.0",
                    "method": "tools/list",
                    "id": "list-1"
                  },
                  {
                    "jsonrpc": "2.0",
                    "method": "notifications/initialized"
                  }
                ],
                "response": [
                  {
                    "jsonrpc": "2.0",
                    "id": "list-1",
                    "result": {
                      "tools": []
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "jsonrpc-exchange-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "jsonrpc-2-exchange-subset-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "complete": {
                          "type": "boolean",
                          "const": false
                        },
                        "requestCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "callCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "notificationCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matchedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matches": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "requestIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "responseIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "id": {
                                "type": [
                                  "string",
                                  "number",
                                  "null"
                                ]
                              },
                              "outcome": {
                                "type": "string",
                                "enum": [
                                  "result",
                                  "error"
                                ]
                              }
                            },
                            "required": [
                              "requestIndex",
                              "responseIndex",
                              "id",
                              "outcome"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "complete",
                        "requestCount",
                        "callCount",
                        "notificationCount",
                        "matchedCount",
                        "matches",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "jsonrpc-exchange-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "jsonrpc-2-exchange-subset-v1",
                    "passesChecks": true,
                    "complete": false,
                    "requestCount": 2,
                    "callCount": 1,
                    "notificationCount": 1,
                    "matchedCount": 1,
                    "matches": [
                      {
                        "requestIndex": 0,
                        "responseIndex": 0,
                        "id": "list-1",
                        "outcome": "result"
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "742afe870cf4c120f98c5b0fff5f0ed903299e18a9f053017e72ed4bfe73ac7d",
                    "outputSha256": "fc52f2b84c59159cb31402bfee7967089b41d95a0cbd5be8dd3a4feb7f7ff15e",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/evidence-quote-check": {
      "post": {
        "operationId": "x402_evidence_quote_check",
        "summary": "Literal Quote Evidence Check",
        "description": "Check exact quotations against supplied source text, including optional UTF-16 start offsets. Returns source SHA-256 fingerprints, occurrence counts, bounded offsets and ambiguity/mismatch findings. Unique scans are capped at 4 million characters and 200,000 located occurrences. Establishes literal correspondence only, never truth, entailment, authenticity or source credibility.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/evidence-quote-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Verify agent-generated quotations against supplied source passages",
            "Locate exact quote offsets and detect ambiguous repeated evidence"
          ],
          "whenToUse": [
            "Verify agent-generated quotations against supplied source passages",
            "Locate exact quote offsets and detect ambiguous repeated evidence"
          ],
          "whenNotToUse": [
            "Fact checking, semantic support, paraphrase matching or source authenticity",
            "Fetching cited URLs or verifying unseen documents"
          ],
          "capabilities": [
            "Exact UTF-16 offsets with source UTF-8 SHA-256",
            "Unique source/literal scans cached; overlapping occurrences counted with a 200,000 aggregate occurrence cap; first 20 locations retained"
          ],
          "related": [
            "citation-coverage-audit",
            "context-budget-pack"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "sources": 100,
            "quotes": 200,
            "matchesPerQuote": 20
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "sources": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "quotes": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "sourceId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 10000
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        }
                      },
                      "required": [
                        "id",
                        "sourceId",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "sources",
                  "quotes"
                ],
                "additionalProperties": false
              },
              "example": {
                "sources": [
                  {
                    "id": "memo",
                    "text": "Launch requires two approvals. Launch date is pending."
                  }
                ],
                "quotes": [
                  {
                    "id": "q1",
                    "sourceId": "memo",
                    "text": "two approvals",
                    "start": 16
                  },
                  {
                    "id": "q2",
                    "sourceId": "memo",
                    "text": "Launch"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "evidence-quote-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "literal-quote-v1"
                        },
                        "allVerified": {
                          "type": "boolean"
                        },
                        "verifiesTruth": {
                          "type": "boolean",
                          "const": false
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16-code-units"
                        },
                        "sources": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "length": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "sha256Utf8": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "length",
                              "sha256Utf8"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "quotes": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "sourceId": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "verified",
                                  "ambiguous",
                                  "not_found",
                                  "location_mismatch",
                                  "source_missing"
                                ]
                              },
                              "occurrenceCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "matches": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "start": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "end": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "start",
                                    "end"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "matchesTruncated": {
                                "type": "boolean"
                              },
                              "requestedStart": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "sourceId",
                              "status",
                              "occurrenceCount",
                              "matches",
                              "matchesTruncated",
                              "requestedStart"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "allVerified",
                        "verifiesTruth",
                        "offsetUnit",
                        "sources",
                        "quotes"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "evidence-quote-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "literal-quote-v1",
                    "allVerified": false,
                    "verifiesTruth": false,
                    "offsetUnit": "UTF-16-code-units",
                    "sources": [
                      {
                        "id": "memo",
                        "length": 54,
                        "sha256Utf8": "f2192aa3501f668ea10cf34d338c5dcab73f0b31644d991b2d7c5cb36d9d69f1"
                      }
                    ],
                    "quotes": [
                      {
                        "id": "q1",
                        "sourceId": "memo",
                        "status": "verified",
                        "occurrenceCount": 1,
                        "matches": [
                          {
                            "start": 16,
                            "end": 29
                          }
                        ],
                        "matchesTruncated": false,
                        "requestedStart": 16
                      },
                      {
                        "id": "q2",
                        "sourceId": "memo",
                        "status": "ambiguous",
                        "occurrenceCount": 2,
                        "matches": [
                          {
                            "start": 0,
                            "end": 6
                          },
                          {
                            "start": 31,
                            "end": 37
                          }
                        ],
                        "matchesTruncated": false,
                        "requestedStart": null
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "9a9594408841790142d74851b491359b5edd3f738300edc0f10a1df0538a28f6",
                    "outputSha256": "ee4c1d855a2c7f287bcfd522c0f153fa1b573ccbc242a4c0155326de5d98d957",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/citation-coverage-audit": {
      "post": {
        "operationId": "x402_citation_coverage_audit",
        "summary": "Citation Coverage Audit",
        "description": "Audit an explicit claim-to-evidence-to-source map for missing required citations, orphan references, duplicate links and unused evidence. Coverage counts valid structural links only; caller declares which claims need citations. No claim extraction, truth scoring or semantic entailment assessment.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/citation-coverage-audit.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Audit citation coverage of an agent report with explicit claim IDs",
            "Find orphan evidence references and unsupported-by-links required claims"
          ],
          "whenToUse": [
            "Audit citation coverage of an agent report with explicit claim IDs",
            "Find orphan evidence references and unsupported-by-links required claims"
          ],
          "whenNotToUse": [
            "Deciding whether evidence proves a claim",
            "Automatically extracting every factual claim from prose"
          ],
          "capabilities": [
            "Claim-level evidence/source edges and uncited IDs",
            "Zero required claims yields null coverage rather than a fabricated score"
          ],
          "related": [
            "evidence-quote-check",
            "context-budget-pack"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "sources": 100,
            "claims": 200,
            "evidence": 200,
            "citations": 500
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "sourceIds": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    }
                  },
                  "claims": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "requiresCitation": {
                          "default": true,
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "evidence": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "sourceId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "id",
                        "sourceId"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "citations": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "claimId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "evidenceId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "claimId",
                        "evidenceId"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "sourceIds",
                  "claims",
                  "evidence",
                  "citations"
                ],
                "additionalProperties": false
              },
              "example": {
                "sourceIds": [
                  "memo"
                ],
                "claims": [
                  {
                    "id": "approval-rule"
                  },
                  {
                    "id": "launch-date"
                  }
                ],
                "evidence": [
                  {
                    "id": "quote-1",
                    "sourceId": "memo"
                  }
                ],
                "citations": [
                  {
                    "claimId": "approval-rule",
                    "evidenceId": "quote-1"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "citation-coverage-audit",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "citation-coverage-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "verifiesTruth": {
                          "type": "boolean",
                          "const": false
                        },
                        "requiredClaimCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "coveredRequiredClaimCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "coverageRatio": {
                          "anyOf": [
                            {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "uncitedClaimIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "unusedEvidenceIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "claimCoverage": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "claimId": {
                                "type": "string"
                              },
                              "requiresCitation": {
                                "type": "boolean"
                              },
                              "evidenceIds": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "sourceIds": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "required": [
                              "claimId",
                              "requiresCitation",
                              "evidenceIds",
                              "sourceIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "verifiesTruth",
                        "requiredClaimCount",
                        "coveredRequiredClaimCount",
                        "coverageRatio",
                        "uncitedClaimIds",
                        "unusedEvidenceIds",
                        "claimCoverage",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "citation-coverage-audit",
                  "version": "0.29.0",
                  "result": {
                    "profile": "citation-coverage-v1",
                    "passesChecks": false,
                    "verifiesTruth": false,
                    "requiredClaimCount": 2,
                    "coveredRequiredClaimCount": 1,
                    "coverageRatio": 0.5,
                    "uncitedClaimIds": [
                      "launch-date"
                    ],
                    "unusedEvidenceIds": [],
                    "claimCoverage": [
                      {
                        "claimId": "approval-rule",
                        "requiresCitation": true,
                        "evidenceIds": [
                          "quote-1"
                        ],
                        "sourceIds": [
                          "memo"
                        ]
                      },
                      {
                        "claimId": "launch-date",
                        "requiresCitation": true,
                        "evidenceIds": [],
                        "sourceIds": []
                      }
                    ],
                    "findings": [
                      {
                        "code": "UNCITED_REQUIRED_CLAIM",
                        "severity": "error",
                        "path": "/claims",
                        "message": "Claim launch-date has no valid evidence-to-source link"
                      }
                    ],
                    "findingCount": 1,
                    "errorCount": 1,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "4f74ca06a726ee2f32a640ff4e79e8fb59ef6c5938e3969ca51faf7d42c4b282",
                    "outputSha256": "3c4d1e1e27ebfe0574ab37e53045fd333d94c31fcbf9f6a3469556cc1fc3f744",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/artifact-manifest-check": {
      "post": {
        "operationId": "x402_artifact_manifest_check",
        "summary": "Supplied Artifact Manifest Check",
        "description": "Compare a supplied text-file manifest with supplied UTF-8 contents: byte sizes, SHA-256 digests, missing/extra/duplicate paths and bounded portable-path collisions. Does not read a filesystem, decode archives, trust an unsigned manifest or verify publisher identity.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/artifact-manifest-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Verify an agent artifact handoff against expected file hashes and sizes",
            "Detect missing files, duplicate paths and portable filename collisions"
          ],
          "whenToUse": [
            "Verify an agent artifact handoff against expected file hashes and sizes",
            "Detect missing files, duplicate paths and portable filename collisions"
          ],
          "whenNotToUse": [
            "Signature verification, malware detection or archive extraction",
            "Reading remote or local files, binary contents, or complete cross-platform filename validation"
          ],
          "capabilities": [
            "UTF-8 SHA-256 and byte-length comparison per entry",
            "Portable subset rejects traversal, controls, reserved names; NFC/ASCII-case collision signals"
          ],
          "related": [
            "content-digest",
            "evidence-quote-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "manifestEntries": 100,
            "files": 100,
            "pathCharacters": 512
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "manifest": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512
                        },
                        "sizeBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        }
                      },
                      "required": [
                        "path",
                        "sizeBytes",
                        "sha256"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "files": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "path",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "allowExtraFiles": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "manifest",
                  "files"
                ],
                "additionalProperties": false
              },
              "example": {
                "manifest": [
                  {
                    "path": "output.txt",
                    "sizeBytes": 5,
                    "sha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
                  }
                ],
                "files": [
                  {
                    "path": "output.txt",
                    "text": "hello"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "artifact-manifest-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "supplied-text-manifest-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "verifiedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "extraPaths": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "entries": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "verified",
                                  "missing",
                                  "ambiguous",
                                  "mismatch",
                                  "invalid_path"
                                ]
                              },
                              "expectedBytes": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "actualBytes": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "expectedSha256": {
                                "type": "string"
                              },
                              "actualSha256": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "path",
                              "status",
                              "expectedBytes",
                              "actualBytes",
                              "expectedSha256",
                              "actualSha256"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "verifiedCount",
                        "extraPaths",
                        "entries",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "artifact-manifest-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "supplied-text-manifest-v1",
                    "passesChecks": true,
                    "verifiedCount": 1,
                    "extraPaths": [],
                    "entries": [
                      {
                        "path": "output.txt",
                        "status": "verified",
                        "expectedBytes": 5,
                        "actualBytes": 5,
                        "expectedSha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
                        "actualSha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "6c419edcbce9b5dcecf7cbc7a8529adb101c74f45956a8021ad1d79a30ad154d",
                    "outputSha256": "cc6ef62785c4ab397fb42be4f1381cf8eb76fbc602deb58c6e21f87dd9c2297d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/retry-schedule-plan": {
      "post": {
        "operationId": "x402_retry_schedule_plan",
        "summary": "Bounded Retry Schedule Plan",
        "description": "Produce a deterministic hypothetical retry wait plan from explicit replay-safety assertions, HTTP status, backoff limits and waiting budget. Supports delta-seconds/IMF-fixdate Retry-After with explicit reference time. Stops for payment uncertainty and unknown/unsafe replay; never sends requests or authorizes repayment.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/retry-schedule-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Calculate capped retry backoff under a fixed waiting budget",
            "Respect Retry-After without clipping the server's minimum wait"
          ],
          "whenToUse": [
            "Calculate capped retry backoff under a fixed waiting budget",
            "Respect Retry-After without clipping the server's minimum wait"
          ],
          "whenNotToUse": [
            "Automatically retrying payment uncertainty or assuming idempotency",
            "Live scheduling, random jitter, traffic synchronization prevention, or complete HTTP-date parsing"
          ],
          "capabilities": [
            "Caller-established replay safety is mandatory",
            "Retry-After profile grounded in https://www.rfc-editor.org/rfc/rfc9110.html#name-retry-after"
          ],
          "related": [
            "workflow-dag-analyze",
            "workflow-transition-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "maxRetries": 10,
            "maxDelayMs": 3600000,
            "budgetMs": 86400000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "outcome": {
                    "type": "string",
                    "enum": [
                      "http-response",
                      "transport-uncertain",
                      "payment-uncertain"
                    ]
                  },
                  "replaySafety": {
                    "type": "string",
                    "enum": [
                      "safe",
                      "unsafe",
                      "unknown"
                    ]
                  },
                  "statusCode": {
                    "type": "integer",
                    "minimum": 100,
                    "maximum": 599
                  },
                  "retryAfter": {
                    "type": "string",
                    "maxLength": 128
                  },
                  "nowEpochMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4102444800000
                  },
                  "retryableStatuses": {
                    "default": [
                      408,
                      429,
                      500,
                      502,
                      503,
                      504
                    ],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 100,
                      "maximum": 599
                    }
                  },
                  "maxRetries": {
                    "default": 3,
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "baseDelayMs": {
                    "default": 1000,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 60000
                  },
                  "multiplier": {
                    "default": 2,
                    "type": "number",
                    "minimum": 1,
                    "maximum": 10
                  },
                  "maxDelayMs": {
                    "default": 60000,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 3600000
                  },
                  "budgetMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 86400000
                  }
                },
                "required": [
                  "outcome",
                  "replaySafety",
                  "budgetMs"
                ],
                "additionalProperties": false
              },
              "example": {
                "outcome": "http-response",
                "replaySafety": "safe",
                "statusCode": 429,
                "retryAfter": "3",
                "maxRetries": 3,
                "baseDelayMs": 1000,
                "multiplier": 2,
                "maxDelayMs": 10000,
                "budgetMs": 10000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "retry-schedule-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "bounded-retry-plan-v1"
                        },
                        "eligible": {
                          "type": "boolean"
                        },
                        "reason": {
                          "type": "string",
                          "enum": [
                            "planned",
                            "payment_reconciliation_required",
                            "replay_safety_not_established",
                            "status_not_retryable",
                            "no_retries_requested",
                            "budget_exhausted",
                            "delay_limit_exceeded"
                          ]
                        },
                        "serverMinimumFirstDelayMs": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "plan": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "retry": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "delayMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "cumulativeDelayMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "retry",
                              "delayMs",
                              "cumulativeDelayMs"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "totalDelayMs": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "unplannedRetries": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "assumptions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "eligible",
                        "reason",
                        "serverMinimumFirstDelayMs",
                        "plan",
                        "totalDelayMs",
                        "unplannedRetries",
                        "assumptions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "retry-schedule-plan",
                  "version": "0.29.0",
                  "result": {
                    "profile": "bounded-retry-plan-v1",
                    "eligible": true,
                    "reason": "planned",
                    "serverMinimumFirstDelayMs": 3000,
                    "plan": [
                      {
                        "retry": 1,
                        "delayMs": 3000,
                        "cumulativeDelayMs": 3000
                      },
                      {
                        "retry": 2,
                        "delayMs": 2000,
                        "cumulativeDelayMs": 5000
                      },
                      {
                        "retry": 3,
                        "delayMs": 4000,
                        "cumulativeDelayMs": 9000
                      }
                    ],
                    "totalDelayMs": 9000,
                    "unplannedRetries": 0,
                    "assumptions": [
                      "Caller must establish replay safety; this plan grants no permission",
                      "No requests, payments, sleeps, or retries are executed",
                      "Hypothetical repeated failures; Retry-After applies only to the first retry",
                      "Budget counts waiting only; excludes execution time and has no jitter"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "a0d7ca9aaa8f91ec282225d6df1edc726e7034f4e317744fc540a2ba2ceef469",
                    "outputSha256": "d257e017c93ed0a51a5b49ecdf7bf20e7ca5190c89ad50c66ae46db72e17ada5",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/context-budget-pack": {
      "post": {
        "operationId": "x402_context_budget_pack",
        "summary": "Evidence Context Budget Pack",
        "description": "Greedily select exact source spans by required status, priority and stable ID within caller-supplied integer cost units. Keeps provenance, rejects broken spans, protects required candidates and deduplicates optional identical text. Does not tokenize, summarize, infer semantic relevance, or guarantee an optimal packing.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/context-budget-pack.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Pack RAG evidence spans into a caller-defined context budget",
            "Keep mandatory excerpts while removing duplicate optional context"
          ],
          "whenToUse": [
            "Pack RAG evidence spans into a caller-defined context budget",
            "Keep mandatory excerpts while removing duplicate optional context"
          ],
          "whenNotToUse": [
            "Tokenizer-accurate model limits or semantic retrieval",
            "Optimal knapsack solutions or verifying caller-provided cost estimates"
          ],
          "capabilities": [
            "Exact source slices with UTF-16 provenance offsets",
            "Required set over budget returns no packed content and an explicit finding"
          ],
          "related": [
            "evidence-quote-check",
            "citation-coverage-audit",
            "text-chunk"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "sources": 100,
            "candidates": 200,
            "budgetUnits": 1000000,
            "candidateSpanCharacters": 2000000,
            "packedTextJsonBytes": 200000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "sources": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "candidates": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "sourceId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "costUnits": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000
                        },
                        "priority": {
                          "default": 0,
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100
                        },
                        "required": {
                          "default": false,
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "id",
                        "sourceId",
                        "start",
                        "end",
                        "costUnits"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "budgetUnits": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "reservedUnits": {
                    "default": 0,
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "deduplicate": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "sources",
                  "candidates",
                  "budgetUnits"
                ],
                "additionalProperties": false
              },
              "example": {
                "sources": [
                  {
                    "id": "memo",
                    "text": "Approval is required. Timing remains tentative."
                  }
                ],
                "candidates": [
                  {
                    "id": "rule",
                    "sourceId": "memo",
                    "start": 0,
                    "end": 21,
                    "costUnits": 6,
                    "required": true
                  },
                  {
                    "id": "timing",
                    "sourceId": "memo",
                    "start": 22,
                    "end": 47,
                    "costUnits": 7,
                    "priority": 50
                  }
                ],
                "budgetUnits": 10,
                "reservedUnits": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "context-budget-pack",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "caller-cost-context-pack-v1"
                        },
                        "requiredSatisfied": {
                          "type": "boolean"
                        },
                        "withinBudget": {
                          "type": "boolean"
                        },
                        "usedUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "remainingUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16-code-units"
                        },
                        "selected": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "sourceId": {
                                "type": "string"
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "text": {
                                "type": "string"
                              },
                              "costUnits": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "priority": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "id",
                              "sourceId",
                              "start",
                              "end",
                              "text",
                              "costUnits",
                              "priority"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "excluded": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "reason": {
                                "type": "string",
                                "enum": [
                                  "invalid_span",
                                  "source_missing",
                                  "duplicate_text",
                                  "budget",
                                  "required_set_over_budget"
                                ]
                              },
                              "duplicateOf": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "reason",
                              "duplicateOf"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "requiredSatisfied",
                        "withinBudget",
                        "usedUnits",
                        "remainingUnits",
                        "offsetUnit",
                        "selected",
                        "excluded",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "context-budget-pack",
                  "version": "0.29.0",
                  "result": {
                    "profile": "caller-cost-context-pack-v1",
                    "requiredSatisfied": true,
                    "withinBudget": true,
                    "usedUnits": 8,
                    "remainingUnits": 2,
                    "offsetUnit": "UTF-16-code-units",
                    "selected": [
                      {
                        "id": "rule",
                        "sourceId": "memo",
                        "start": 0,
                        "end": 21,
                        "text": "Approval is required.",
                        "costUnits": 6,
                        "priority": 0
                      }
                    ],
                    "excluded": [
                      {
                        "id": "timing",
                        "reason": "budget",
                        "duplicateOf": null
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "27002969c140cfec802a9a9ff54a31c3c1a8973494991dfcd1646f7dd2adb7c2",
                    "outputSha256": "49b7a91bf4e79e98bdf9a81e0c3d6ab67a7d9b6fcf7e8f502c34771b2d1906a4",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/causal-log-check": {
      "post": {
        "operationId": "x402_causal_log_check",
        "summary": "Causal event log check",
        "description": "Check a supplied multi-agent log against vector clocks, actor sequence continuity, baseline history and explicit parents; report unobserved dependencies and concurrent-clock pairs. Does not execute or authenticate history.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/causal-log-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Detect missing causal history in a multi-agent event log",
            "Check vector clock regressions and out-of-order agent messages before offline replay"
          ],
          "whenToUse": [
            "Detect missing causal history in a multi-agent event log",
            "Check vector clock regressions and out-of-order agent messages before offline replay"
          ],
          "whenNotToUse": [
            "Executing tools, sending messages, retrying effects, restoring state, or contacting live services",
            "Authenticating evidence, verifying signatures or identities, granting permission, or enforcing authorization",
            "Inferring facts omitted from the supplied artifact snapshot or guaranteeing exactly-once execution"
          ],
          "capabilities": [
            "causal-log-v1 profile",
            "Baseline continuation, per-actor counters and explicit parent clock dominance",
            "Missing inferred dependencies and bounded concurrent-clock evidence",
            "Advisory only; authorizationGranted=false; identityVerified=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "events": 256,
            "actors": 32,
            "traceSteps": 128,
            "observations": 256,
            "parentReferencesPerEvent": 32,
            "concurrentPairs": 64,
            "causalPairChecks": 32640
          },
          "related": [
            "replay-divergence-check",
            "checkpoint-handoff-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "ACTOR_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "baseline": {
                    "default": [],
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "actor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "counter": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "actor",
                        "counter"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "events": {
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "actor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "sequence": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991
                        },
                        "parents": {
                          "default": [],
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "clock": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "actor": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "counter": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "actor",
                              "counter"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "actor",
                        "sequence",
                        "clock"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "events"
                ],
                "additionalProperties": false
              },
              "example": {
                "baseline": [],
                "events": [
                  {
                    "id": "a1",
                    "actor": "planner",
                    "sequence": 1,
                    "parents": [],
                    "clock": [
                      {
                        "actor": "planner",
                        "counter": 1
                      }
                    ]
                  },
                  {
                    "id": "b1",
                    "actor": "worker",
                    "sequence": 1,
                    "parents": [
                      "a1"
                    ],
                    "clock": [
                      {
                        "actor": "planner",
                        "counter": 1
                      },
                      {
                        "actor": "worker",
                        "counter": 1
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "causal-log-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "causal-log-v1"
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "eventCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "finalObservedClock": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "actor": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "counter": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "actor",
                              "counter"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "concurrentPairCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "concurrentPairs": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "left": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "right": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "required": [
                              "left",
                              "right"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "concurrentPairsTruncated": {
                          "type": "boolean"
                        },
                        "limitations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "consistent",
                        "advisoryOnly",
                        "eventCount",
                        "finalObservedClock",
                        "concurrentPairCount",
                        "concurrentPairs",
                        "concurrentPairsTruncated",
                        "limitations",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "causal-log-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "causal-log-v1",
                    "consistent": true,
                    "advisoryOnly": true,
                    "eventCount": 2,
                    "finalObservedClock": [
                      {
                        "actor": "planner",
                        "counter": 1
                      },
                      {
                        "actor": "worker",
                        "counter": 1
                      }
                    ],
                    "concurrentPairCount": 0,
                    "concurrentPairs": [],
                    "concurrentPairsTruncated": false,
                    "limitations": [
                      "Vector clocks and baseline are caller assertions, not authenticated history.",
                      "Input order must be a complete causal continuation of the baseline; explicit parents must be present even when covered by the baseline.",
                      "Concurrency describes supplied clock vectors and is not a conflict or a wall-clock ordering guarantee."
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "803aa46ee613401f0dc872cd13b8014258561eee5dba1dde1e0dd405af746fad",
                    "outputSha256": "8106034465bf192f701a91289769a3de196df7ea27fd5643c3441c058798035a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/replay-divergence-check": {
      "post": {
        "operationId": "x402_replay_divergence_check",
        "summary": "Replay trace divergence check",
        "description": "Align two supplied execution traces by stable step ID, distinguish reordered/missing/extra steps and compare operation, canonical JSON requests, outcomes and result presence. Returns digest evidence without executing a replay.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/replay-divergence-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Locate deterministic replay divergence between recorded agent runs",
            "Compare step-level requests and outputs after a tool or prompt upgrade"
          ],
          "whenToUse": [
            "Locate deterministic replay divergence between recorded agent runs",
            "Compare step-level requests and outputs after a tool or prompt upgrade"
          ],
          "whenNotToUse": [
            "Executing tools, sending messages, retrying effects, restoring state, or contacting live services",
            "Authenticating evidence, verifying signatures or identities, granting permission, or enforcing authorization",
            "Inferring facts omitted from the supplied artifact snapshot or guaranteeing exactly-once execution"
          ],
          "capabilities": [
            "replay-divergence-v1 profile",
            "Stable-ID alignment, exact common-step order and matching prefix",
            "Presence-aware result hashes using sorted-json-sha256-v1",
            "Advisory only; authorizationGranted=false; identityVerified=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "events": 256,
            "actors": 32,
            "traceSteps": 128,
            "observations": 256,
            "stepsPerTrace": 128
          },
          "related": [
            "causal-log-check",
            "idempotency-conflict-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "ACTOR_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "baseline": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "operation": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "request": {
                          "$ref": "#/paths/~1v1~1x402~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        },
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "success",
                            "error",
                            "unknown"
                          ]
                        },
                        "result": {
                          "$ref": "#/paths/~1v1~1x402~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "required": [
                        "id",
                        "operation",
                        "request",
                        "outcome"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "candidate": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "operation": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "request": {
                          "$ref": "#/paths/~1v1~1x402~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        },
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "success",
                            "error",
                            "unknown"
                          ]
                        },
                        "result": {
                          "$ref": "#/paths/~1v1~1x402~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "required": [
                        "id",
                        "operation",
                        "request",
                        "outcome"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "baseline",
                  "candidate"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "baseline": [
                  {
                    "id": "step-1",
                    "operation": "extract",
                    "request": {
                      "text": "hello"
                    },
                    "outcome": "success",
                    "result": {
                      "count": 1
                    }
                  }
                ],
                "candidate": [
                  {
                    "id": "step-1",
                    "operation": "extract",
                    "request": {
                      "text": "hello"
                    },
                    "outcome": "success",
                    "result": {
                      "count": 2
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "replay-divergence-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "replay-divergence-v1"
                        },
                        "equivalent": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "digestProfile": {
                          "type": "string",
                          "const": "sorted-json-sha256-v1"
                        },
                        "matchingPrefixLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "commonStepCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "orderPreserved": {
                          "type": "boolean"
                        },
                        "firstDivergence": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "index": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "baselineId": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "candidateId": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "index",
                                "baselineId",
                                "candidateId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "missingStepIds": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "extraStepIds": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "comparisons": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "baselineIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "candidateIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "sameOperation": {
                                "type": "boolean"
                              },
                              "sameRequest": {
                                "type": "boolean"
                              },
                              "sameOutcome": {
                                "type": "boolean"
                              },
                              "sameResult": {
                                "type": "boolean"
                              },
                              "baselineRequestSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "candidateRequestSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "baselineResultSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "candidateResultSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              }
                            },
                            "required": [
                              "id",
                              "baselineIndex",
                              "candidateIndex",
                              "sameOperation",
                              "sameRequest",
                              "sameOutcome",
                              "sameResult",
                              "baselineRequestSha256",
                              "candidateRequestSha256",
                              "baselineResultSha256",
                              "candidateResultSha256"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "limitations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "equivalent",
                        "advisoryOnly",
                        "digestProfile",
                        "matchingPrefixLength",
                        "commonStepCount",
                        "orderPreserved",
                        "firstDivergence",
                        "missingStepIds",
                        "extraStepIds",
                        "comparisons",
                        "limitations",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "replay-divergence-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "replay-divergence-v1",
                    "equivalent": false,
                    "advisoryOnly": true,
                    "digestProfile": "sorted-json-sha256-v1",
                    "matchingPrefixLength": 0,
                    "commonStepCount": 1,
                    "orderPreserved": true,
                    "firstDivergence": {
                      "index": 0,
                      "baselineId": "step-1",
                      "candidateId": "step-1"
                    },
                    "missingStepIds": [],
                    "extraStepIds": [],
                    "comparisons": [
                      {
                        "id": "step-1",
                        "baselineIndex": 0,
                        "candidateIndex": 0,
                        "sameOperation": true,
                        "sameRequest": true,
                        "sameOutcome": true,
                        "sameResult": false,
                        "baselineRequestSha256": "cbbbdcd27692344de5dbab3abcaba413fb0f45307267de7081401576df1cb176",
                        "candidateRequestSha256": "cbbbdcd27692344de5dbab3abcaba413fb0f45307267de7081401576df1cb176",
                        "baselineResultSha256": "dda59c1dd5dc7304423acc22eafddcb12e7550b4a1ac96525c6ea6eb8bcd5313",
                        "candidateResultSha256": "8ea34acc65cbbb9d9d54427c6a777d14668c7a6443bcdb56ad56fbfaf6de413e"
                      }
                    ],
                    "limitations": [
                      "Compares exact supplied JSON traces without executing or predicting a replay.",
                      "Step IDs must be unique within each trace; repeated attempts need distinct IDs.",
                      "Digest profile sorts keys by UTF-16 and uses JavaScript JSON numbers; it is not RFC 8785 or a signature. Result hashes include presence so absent differs from null.",
                      "Unknown outcomes and omitted effects cannot establish equivalent behavior outside these traces."
                    ],
                    "findings": [
                      {
                        "code": "RESULT_DIVERGED",
                        "severity": "error",
                        "path": "/candidate/0",
                        "message": "result differs from the aligned baseline step",
                        "relatedIds": [
                          "step-1"
                        ]
                      }
                    ],
                    "findingCount": 1,
                    "errorCount": 1,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "7053e487f5944c064974aeea44d3a57370d71b16669bb704de01deaedfce2fd7",
                    "outputSha256": "23ef080e8f51a0ad59ece5d5958fdc0221beed339139c5c8dd0c14465934f17e",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/idempotency-conflict-check": {
      "post": {
        "operationId": "x402_idempotency_conflict_check",
        "summary": "Idempotency observation conflict check",
        "description": "Group supplied attempts by exact scope and idempotency key; find conflicting operation/request or success-result fingerprints and unresolved/stale pending outcomes. Advisory reconciliation only, never retry permission.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/idempotency-conflict-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find conflicting idempotency keys before retrying an uncertain agent tool call",
            "Triage duplicate success receipts and stale pending attempt logs"
          ],
          "whenToUse": [
            "Find conflicting idempotency keys before retrying an uncertain agent tool call",
            "Triage duplicate success receipts and stale pending attempt logs"
          ],
          "whenNotToUse": [
            "Executing tools, sending messages, retrying effects, restoring state, or contacting live services",
            "Authenticating evidence, verifying signatures or identities, granting permission, or enforcing authorization",
            "Inferring facts omitted from the supplied artifact snapshot or guaranteeing exactly-once execution"
          ],
          "capabilities": [
            "idempotency-conflict-v1 profile",
            "Exact (scope,key) grouping and operation/request fingerprints",
            "Conflicting successful responses and unresolved outcome review dispositions",
            "Advisory only; authorizationGranted=false; identityVerified=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "events": 256,
            "actors": 32,
            "traceSteps": 128,
            "observations": 256,
            "pendingTimeoutMaxMs": 604800000
          },
          "related": [
            "checkpoint-handoff-check",
            "retry-schedule-plan",
            "replay-divergence-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "ACTOR_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "asOfMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "pendingTimeoutMs": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 604800000
                  },
                  "observations": {
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "scope": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "key": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "operation": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "request": {
                          "$ref": "#/paths/~1v1~1x402~1idempotency-conflict-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        },
                        "observedAtMs": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "pending",
                            "success",
                            "failure",
                            "unknown"
                          ]
                        },
                        "result": {
                          "$ref": "#/paths/~1v1~1x402~1idempotency-conflict-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "required": [
                        "id",
                        "scope",
                        "key",
                        "operation",
                        "request",
                        "observedAtMs",
                        "status"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "asOfMs",
                  "pendingTimeoutMs",
                  "observations"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1idempotency-conflict-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1idempotency-conflict-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "asOfMs": 10000,
                "pendingTimeoutMs": 5000,
                "observations": [
                  {
                    "id": "attempt-1",
                    "scope": "orders:create",
                    "key": "job-42",
                    "operation": "create-order",
                    "request": {
                      "sku": "A",
                      "quantity": 1
                    },
                    "observedAtMs": 1000,
                    "status": "unknown"
                  },
                  {
                    "id": "attempt-2",
                    "scope": "orders:create",
                    "key": "job-42",
                    "operation": "create-order",
                    "request": {
                      "sku": "A",
                      "quantity": 2
                    },
                    "observedAtMs": 2000,
                    "status": "pending"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "idempotency-conflict-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "idempotency-conflict-v1"
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "digestProfile": {
                          "type": "string",
                          "const": "sorted-json-sha256-v1"
                        },
                        "groups": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "scope": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "key": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "observationIds": {
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              },
                              "requestSha256s": {
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[a-f0-9]{64}$"
                                }
                              },
                              "successfulResultSha256s": {
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[a-f0-9]{64}$"
                                }
                              },
                              "conflict": {
                                "type": "boolean"
                              },
                              "unknownOutcome": {
                                "type": "boolean"
                              },
                              "stalePending": {
                                "type": "boolean"
                              },
                              "disposition": {
                                "type": "string",
                                "enum": [
                                  "reconcile_conflict",
                                  "reconcile_unknown",
                                  "await_pending",
                                  "inspect_recorded_success",
                                  "inspect_failed_attempts"
                                ]
                              }
                            },
                            "required": [
                              "scope",
                              "key",
                              "observationIds",
                              "requestSha256s",
                              "successfulResultSha256s",
                              "conflict",
                              "unknownOutcome",
                              "stalePending",
                              "disposition"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "limitations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "consistent",
                        "advisoryOnly",
                        "digestProfile",
                        "groups",
                        "limitations",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "idempotency-conflict-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "idempotency-conflict-v1",
                    "consistent": false,
                    "advisoryOnly": true,
                    "digestProfile": "sorted-json-sha256-v1",
                    "groups": [
                      {
                        "scope": "orders:create",
                        "key": "job-42",
                        "observationIds": [
                          "attempt-1",
                          "attempt-2"
                        ],
                        "requestSha256s": [
                          "7488fe0cd2d6e45a4a0200317d4531f76a5eb754864f5c1b9198d9f23380e1e5",
                          "f9d1806b28d3a6f92838c9d28bb6fd8832fc04dc74668f7427e989973d65527d"
                        ],
                        "successfulResultSha256s": [],
                        "conflict": true,
                        "unknownOutcome": true,
                        "stalePending": true,
                        "disposition": "reconcile_conflict"
                      }
                    ],
                    "limitations": [
                      "The namespace is exactly (scope,key); provider retention windows and key-generation changes are not inferred.",
                      "No result authorizes a retry, proves that an effect occurred once, or checks a provider's live idempotency store.",
                      "Pending and unknown records remain unresolved even if another record reports success; caller reconciliation is required.",
                      "Request fingerprints cover operation and request. Successful-result hashes cover supplied JSON only and are not authenticated receipts."
                    ],
                    "findings": [
                      {
                        "code": "UNKNOWN_OUTCOME",
                        "severity": "warning",
                        "path": "/observations/0/status",
                        "message": "Reconcile provider evidence before considering another attempt",
                        "relatedIds": [
                          "attempt-1"
                        ]
                      },
                      {
                        "code": "STALE_PENDING",
                        "severity": "warning",
                        "path": "/observations/1",
                        "message": "Pending observation exceeded the supplied review timeout; this does not prove failure",
                        "relatedIds": [
                          "attempt-2"
                        ]
                      },
                      {
                        "code": "KEY_REQUEST_CONFLICT",
                        "severity": "error",
                        "path": "/observations/0/key",
                        "message": "The same scope and key were used for different operation/request fingerprints",
                        "relatedIds": [
                          "attempt-1",
                          "attempt-2"
                        ]
                      }
                    ],
                    "findingCount": 3,
                    "errorCount": 1,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "6eefc98b638cd666018d9da7909bff489df07808a56386ae3571e13cb517cc6b",
                    "outputSha256": "9574ce734c89446b01aa669ff3910e3a98b76f8b9c5612cd0484bce978afd441",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/approval-scope-check": {
      "post": {
        "operationId": "x402_approval_scope_check",
        "summary": "Supplied approval scope comparison",
        "description": "Compare a structured caller-supplied approval receipt to a proposed action: exact actor and scope, declared data-class subset, payload digest, caller time window, revocation and use count. Does not authenticate or grant authorization.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/approval-scope-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Detect scope drift or expiry in an offline human-approval receipt",
            "Compare a proposed action with an exact structured approval artifact before human review"
          ],
          "whenToUse": [
            "Detect scope drift or expiry in an offline human-approval receipt",
            "Compare a proposed action with an exact structured approval artifact before human review"
          ],
          "whenNotToUse": [
            "Executing tools, sending messages, retrying effects, restoring state, or contacting live services",
            "Authenticating evidence, verifying signatures or identities, granting permission, or enforcing authorization",
            "Inferring facts omitted from the supplied artifact snapshot or guaranteeing exactly-once execution"
          ],
          "capabilities": [
            "approval-scope-v1 profile",
            "Exact scope and payload digest comparison with declared data-class subset",
            "Exclusive expiry and usage-count assertions; authorizationGranted=false and identityVerified=false",
            "Advisory only; authorizationGranted=false; identityVerified=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "events": 256,
            "actors": 32,
            "traceSteps": 128,
            "observations": 256,
            "dataClassesPerScope": 16,
            "scopeMatching": "exact case-sensitive strings; no wildcards"
          },
          "related": [
            "checkpoint-handoff-check",
            "json-canonicalize"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "ACTOR_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "asOfMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "approval": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "actor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "scope": {
                        "type": "object",
                        "properties": {
                          "operation": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "recipient": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "resource": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "purpose": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "dataClasses": {
                            "maxItems": 16,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            }
                          }
                        },
                        "required": [
                          "operation",
                          "recipient",
                          "resource",
                          "purpose",
                          "dataClasses"
                        ],
                        "additionalProperties": false
                      },
                      "payloadSha256": {
                        "type": "string",
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "issuedAtMs": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "expiresAtMs": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "revoked": {
                        "type": "boolean"
                      },
                      "maxUses": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      },
                      "priorUses": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000
                      }
                    },
                    "required": [
                      "id",
                      "actor",
                      "scope",
                      "payloadSha256",
                      "issuedAtMs",
                      "expiresAtMs",
                      "revoked",
                      "maxUses",
                      "priorUses"
                    ],
                    "additionalProperties": false
                  },
                  "proposal": {
                    "type": "object",
                    "properties": {
                      "actor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "scope": {
                        "type": "object",
                        "properties": {
                          "operation": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "recipient": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "resource": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "purpose": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "dataClasses": {
                            "maxItems": 16,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            }
                          }
                        },
                        "required": [
                          "operation",
                          "recipient",
                          "resource",
                          "purpose",
                          "dataClasses"
                        ],
                        "additionalProperties": false
                      },
                      "payload": {
                        "$ref": "#/paths/~1v1~1x402~1approval-scope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    },
                    "required": [
                      "actor",
                      "scope",
                      "payload"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "asOfMs",
                  "approval",
                  "proposal"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1approval-scope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1approval-scope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "asOfMs": 100,
                "approval": {
                  "id": "approval-1",
                  "actor": "agent-1",
                  "scope": {
                    "operation": "send-note",
                    "recipient": "team@example.test",
                    "resource": "thread-1",
                    "purpose": "status-update",
                    "dataClasses": [
                      "business-contact"
                    ]
                  },
                  "payloadSha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                  "issuedAtMs": 0,
                  "expiresAtMs": 1000,
                  "revoked": false,
                  "maxUses": 1,
                  "priorUses": 0
                },
                "proposal": {
                  "actor": "agent-1",
                  "scope": {
                    "operation": "send-note",
                    "recipient": "team@example.test",
                    "resource": "thread-1",
                    "purpose": "status-update",
                    "dataClasses": [
                      "business-contact"
                    ]
                  },
                  "payload": {}
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "approval-scope-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "approval-scope-v1"
                        },
                        "matchesSuppliedApproval": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        },
                        "identityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "approvalId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "payloadSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "digestProfile": {
                          "type": "string",
                          "const": "sorted-json-sha256-v1"
                        },
                        "checks": {
                          "type": "object",
                          "properties": {
                            "actor": {
                              "type": "boolean"
                            },
                            "operation": {
                              "type": "boolean"
                            },
                            "recipient": {
                              "type": "boolean"
                            },
                            "resource": {
                              "type": "boolean"
                            },
                            "purpose": {
                              "type": "boolean"
                            },
                            "dataClasses": {
                              "type": "boolean"
                            },
                            "payload": {
                              "type": "boolean"
                            },
                            "timeWindow": {
                              "type": "boolean"
                            },
                            "notRevoked": {
                              "type": "boolean"
                            },
                            "usesRemaining": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "actor",
                            "operation",
                            "recipient",
                            "resource",
                            "purpose",
                            "dataClasses",
                            "payload",
                            "timeWindow",
                            "notRevoked",
                            "usesRemaining"
                          ],
                          "additionalProperties": false
                        },
                        "limitations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "matchesSuppliedApproval",
                        "advisoryOnly",
                        "authorizationGranted",
                        "identityVerified",
                        "approvalId",
                        "payloadSha256",
                        "digestProfile",
                        "checks",
                        "limitations",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "approval-scope-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "approval-scope-v1",
                    "matchesSuppliedApproval": true,
                    "advisoryOnly": true,
                    "authorizationGranted": false,
                    "identityVerified": false,
                    "approvalId": "approval-1",
                    "payloadSha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                    "digestProfile": "sorted-json-sha256-v1",
                    "checks": {
                      "actor": true,
                      "operation": true,
                      "recipient": true,
                      "resource": true,
                      "purpose": true,
                      "dataClasses": true,
                      "payload": true,
                      "timeWindow": true,
                      "notRevoked": true,
                      "usesRemaining": true
                    },
                    "limitations": [
                      "All approval, identity, revocation, usage and time inputs are unverified caller assertions.",
                      "This is an offline comparison and never grants or substitutes for required human approval or an authorization service.",
                      "Scope strings are exact and case-sensitive; no wildcards, URL equivalence, delegation, or implicit recipient expansion.",
                      "Proposal data classes must be a subset of the declared approved classes; their truth is not inferred from payload contents.",
                      "The payload digest uses the custom sorted-json-sha256-v1 profile, not a signature or general canonical JSON standard."
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "1dad1a8fc0a2aa96d0cc1216c1f6ba3500c4f2d51b51098c2ef5dba80d4ee048",
                    "outputSha256": "01cfe41c857b2418ca2e408aed082517f8dbfcfea2e59f557c77bfebd62c823a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/checkpoint-handoff-check": {
      "post": {
        "operationId": "x402_checkpoint_handoff_check",
        "summary": "Checkpoint handoff consistency check",
        "description": "Compare a checkpoint with a proposed resume packet: workflow/consumer/revision, JSON state digest, required artifact manifests, exact stream cursors and pending-effect receipts. Reports reconciliation blockers; never restores or dispatches anything.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/checkpoint-handoff-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Check an agent checkpoint handoff before resuming after interruption",
            "Find missing artifacts, cursor gaps and uncertain side effects in a recovery packet"
          ],
          "whenToUse": [
            "Check an agent checkpoint handoff before resuming after interruption",
            "Find missing artifacts, cursor gaps and uncertain side effects in a recovery packet"
          ],
          "whenNotToUse": [
            "Executing tools, sending messages, retrying effects, restoring state, or contacting live services",
            "Authenticating evidence, verifying signatures or identities, granting permission, or enforcing authorization",
            "Inferring facts omitted from the supplied artifact snapshot or guaranteeing exactly-once execution"
          ],
          "capabilities": [
            "checkpoint-handoff-v1 profile",
            "State digest, required manifest and exact cursor cross-reference checks",
            "Prepared/submitted/acknowledged effect receipt reconciliation; authorizationGranted=false",
            "Advisory only; authorizationGranted=false; identityVerified=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "events": 256,
            "actors": 32,
            "traceSteps": 128,
            "observations": 256,
            "artifacts": 128,
            "cursors": 128,
            "effects": 128,
            "receipts": 128
          },
          "related": [
            "causal-log-check",
            "idempotency-conflict-check",
            "approval-scope-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "ACTOR_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "checkpoint": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "workflowId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "revision": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "consumer": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "createdAtMs": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "expiresAtMs": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "stateSha256": {
                        "type": "string",
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "artifacts": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "sha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            },
                            "required": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "id",
                            "sha256",
                            "required"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "cursors": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "stream": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "nextSequence": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "stream",
                            "nextSequence"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "effects": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "requestSha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            },
                            "phase": {
                              "type": "string",
                              "enum": [
                                "prepared",
                                "submitted",
                                "acknowledged"
                              ]
                            },
                            "receiptId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            }
                          },
                          "required": [
                            "id",
                            "requestSha256",
                            "phase"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "id",
                      "workflowId",
                      "revision",
                      "consumer",
                      "createdAtMs",
                      "expiresAtMs",
                      "stateSha256",
                      "artifacts",
                      "cursors",
                      "effects"
                    ],
                    "additionalProperties": false
                  },
                  "resume": {
                    "type": "object",
                    "properties": {
                      "workflowId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "expectedRevision": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "consumer": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "asOfMs": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "state": {
                        "$ref": "#/paths/~1v1~1x402~1checkpoint-handoff-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      },
                      "artifacts": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "sha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            }
                          },
                          "required": [
                            "id",
                            "sha256"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "cursors": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "stream": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "nextSequence": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "stream",
                            "nextSequence"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "receipts": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "effectId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "requestSha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            },
                            "receiptId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "outcome": {
                              "type": "string",
                              "enum": [
                                "success",
                                "failure"
                              ]
                            }
                          },
                          "required": [
                            "effectId",
                            "requestSha256",
                            "receiptId",
                            "outcome"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "workflowId",
                      "expectedRevision",
                      "consumer",
                      "asOfMs",
                      "state",
                      "artifacts",
                      "cursors",
                      "receipts"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "checkpoint",
                  "resume"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1checkpoint-handoff-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1checkpoint-handoff-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "checkpoint": {
                  "id": "checkpoint-1",
                  "workflowId": "workflow-1",
                  "revision": 3,
                  "consumer": "agent-b",
                  "createdAtMs": 0,
                  "expiresAtMs": 1000,
                  "stateSha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                  "artifacts": [
                    {
                      "id": "plan",
                      "sha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                      "required": true
                    }
                  ],
                  "cursors": [
                    {
                      "stream": "events",
                      "nextSequence": 4
                    }
                  ],
                  "effects": [
                    {
                      "id": "send-1",
                      "requestSha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                      "phase": "submitted"
                    }
                  ]
                },
                "resume": {
                  "workflowId": "workflow-1",
                  "expectedRevision": 3,
                  "consumer": "agent-b",
                  "asOfMs": 100,
                  "state": {},
                  "artifacts": [
                    {
                      "id": "plan",
                      "sha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a"
                    }
                  ],
                  "cursors": [
                    {
                      "stream": "events",
                      "nextSequence": 4
                    }
                  ],
                  "receipts": []
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "checkpoint-handoff-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "checkpoint-handoff-v1"
                        },
                        "matchesCheckpoint": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        },
                        "checkpointId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "stateSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "digestProfile": {
                          "type": "string",
                          "const": "sorted-json-sha256-v1"
                        },
                        "requiresEffectReconciliation": {
                          "type": "boolean"
                        },
                        "artifactChecks": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "required": {
                                "type": "boolean"
                              },
                              "present": {
                                "type": "boolean"
                              },
                              "digestMatches": {
                                "type": [
                                  "boolean",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "required",
                              "present",
                              "digestMatches"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "cursorChecks": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "stream": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "expectedNextSequence": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "suppliedNextSequence": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "matches": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "stream",
                              "expectedNextSequence",
                              "suppliedNextSequence",
                              "matches"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "effectChecks": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "disposition": {
                                "type": "string",
                                "enum": [
                                  "unsubmitted_claim",
                                  "settled_by_supplied_receipt",
                                  "unresolved"
                                ]
                              },
                              "suppliedOutcome": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "enum": [
                                      "success",
                                      "failure"
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "disposition",
                              "suppliedOutcome"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "limitations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "matchesCheckpoint",
                        "advisoryOnly",
                        "authorizationGranted",
                        "checkpointId",
                        "stateSha256",
                        "digestProfile",
                        "requiresEffectReconciliation",
                        "artifactChecks",
                        "cursorChecks",
                        "effectChecks",
                        "limitations",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "checkpoint-handoff-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "checkpoint-handoff-v1",
                    "matchesCheckpoint": false,
                    "advisoryOnly": true,
                    "authorizationGranted": false,
                    "checkpointId": "checkpoint-1",
                    "stateSha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                    "digestProfile": "sorted-json-sha256-v1",
                    "requiresEffectReconciliation": true,
                    "artifactChecks": [
                      {
                        "id": "plan",
                        "required": true,
                        "present": true,
                        "digestMatches": true
                      }
                    ],
                    "cursorChecks": [
                      {
                        "stream": "events",
                        "expectedNextSequence": 4,
                        "suppliedNextSequence": 4,
                        "matches": true
                      }
                    ],
                    "effectChecks": [
                      {
                        "id": "send-1",
                        "disposition": "unresolved",
                        "suppliedOutcome": null
                      }
                    ],
                    "limitations": [
                      "Does not restore a checkpoint, dispatch an effect, verify identities, or authorize resumption.",
                      "State is hashed from supplied JSON. Artifact digests, receipts, phases and timestamps are compared as unverified claims; file bytes and provider state are not fetched.",
                      "Cursor nextSequence means the next unconsumed record in the caller's declared stream; equality does not prove no records were omitted.",
                      "A prepared phase is only an unsubmitted claim and is not evidence that dispatch is safe. Settled receipts do not prove exactly-once execution."
                    ],
                    "findings": [
                      {
                        "code": "EFFECT_RECEIPT_MISSING",
                        "severity": "error",
                        "path": "/checkpoint/effects/0",
                        "message": "Submitted or acknowledged effect requires a supplied receipt before reconciliation can complete",
                        "relatedIds": [
                          "send-1"
                        ]
                      }
                    ],
                    "findingCount": 1,
                    "errorCount": 1,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "d87ea4eabd4d2082ffa6fcef60b3ef17629a31bee0613b0cf1146fc71a3aab7e",
                    "outputSha256": "217ca73ac9f3bc755a530f25479c5a843646777c21b10015e9740f63d5fe2820",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/contract-capability-negotiate": {
      "post": {
        "operationId": "x402_contract_capability_negotiate",
        "summary": "Contract capability intersection",
        "description": "Intersect 2–8 supplied capability offers, exact protocol/version/media identifiers and bounded size intervals. Return a deterministic common proposal or explicit conflicts; no negotiation, schema compatibility proof or authorization occurs.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/contract-capability-negotiate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find a common contract version and declared capabilities between agents",
            "Compare message and batch limits before exchanging artifacts"
          ],
          "whenToUse": [
            "Find a common contract version and declared capabilities between agents",
            "Compare message and batch limits before exchanging artifacts"
          ],
          "whenNotToUse": [
            "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution",
            "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees",
            "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness"
          ],
          "capabilities": [
            "Exact set intersection and required-capability union",
            "Inclusive integer size intervals; lexicographic choice is not newest-version selection",
            "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "parties": 8,
            "versionsPerParty": 32,
            "capabilitiesPerParty": 32
          },
          "related": [
            "json-schema-compatibility",
            "contract-version-route"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "VERSION_LIMIT",
            "ITEM_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "offers": {
                    "minItems": 2,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "party": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "protocol": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "versions": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "mediaTypes": {
                          "minItems": 1,
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "capabilities": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "requiredCapabilities": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "minimumMessageBytes": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100000000
                        },
                        "maximumMessageBytes": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100000000
                        },
                        "minimumBatchItems": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10000
                        },
                        "maximumBatchItems": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10000
                        }
                      },
                      "required": [
                        "party",
                        "protocol",
                        "versions",
                        "mediaTypes",
                        "capabilities",
                        "requiredCapabilities",
                        "minimumMessageBytes",
                        "maximumMessageBytes",
                        "minimumBatchItems",
                        "maximumBatchItems"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "offers"
                ],
                "additionalProperties": false
              },
              "example": {
                "offers": [
                  {
                    "party": "producer",
                    "protocol": "agent-exchange",
                    "versions": [
                      "1",
                      "2"
                    ],
                    "mediaTypes": [
                      "application/json"
                    ],
                    "capabilities": [
                      "cursor",
                      "digest"
                    ],
                    "requiredCapabilities": [
                      "digest"
                    ],
                    "minimumMessageBytes": 1,
                    "maximumMessageBytes": 65536,
                    "minimumBatchItems": 1,
                    "maximumBatchItems": 32
                  },
                  {
                    "party": "consumer",
                    "protocol": "agent-exchange",
                    "versions": [
                      "2"
                    ],
                    "mediaTypes": [
                      "application/json"
                    ],
                    "capabilities": [
                      "cursor",
                      "digest"
                    ],
                    "requiredCapabilities": [
                      "digest"
                    ],
                    "minimumMessageBytes": 1,
                    "maximumMessageBytes": 32768,
                    "minimumBatchItems": 1,
                    "maximumBatchItems": 32
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "contract-capability-negotiate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "contract-capability-intersection-v1"
                        },
                        "compatibleDeclarations": {
                          "type": "boolean"
                        },
                        "protocol": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "commonVersions": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "commonMediaTypes": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "commonCapabilities": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "requiredCapabilities": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "selection": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "version": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "minimumMessageBytes": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "maximumMessageBytes": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "minimumBatchItems": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "maximumBatchItems": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "version",
                                "mediaType",
                                "minimumMessageBytes",
                                "maximumMessageBytes",
                                "minimumBatchItems",
                                "maximumBatchItems"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "selectionPolicy": {
                          "type": "string",
                          "const": "lexicographic-first-version-and-media-type"
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "compatibleDeclarations",
                        "protocol",
                        "commonVersions",
                        "commonMediaTypes",
                        "commonCapabilities",
                        "requiredCapabilities",
                        "selection",
                        "selectionPolicy",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated",
                        "advisoryOnly",
                        "execution",
                        "authorizationGranted"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "contract-capability-negotiate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "contract-capability-intersection-v1",
                    "compatibleDeclarations": true,
                    "protocol": "agent-exchange",
                    "commonVersions": [
                      "2"
                    ],
                    "commonMediaTypes": [
                      "application/json"
                    ],
                    "commonCapabilities": [
                      "cursor",
                      "digest"
                    ],
                    "requiredCapabilities": [
                      "digest"
                    ],
                    "selection": {
                      "version": "2",
                      "mediaType": "application/json",
                      "minimumMessageBytes": 1,
                      "maximumMessageBytes": 32768,
                      "minimumBatchItems": 1,
                      "maximumBatchItems": 32
                    },
                    "selectionPolicy": "lexicographic-first-version-and-media-type",
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false,
                    "advisoryOnly": true,
                    "execution": false,
                    "authorizationGranted": false
                  },
                  "provenance": {
                    "inputSha256": "4fb7645310512b039a130583f3563bf82879d9a262987e2fe833361cb966f2e6",
                    "outputSha256": "92caafb7a800cd6179eff138af48895244dd681561014116a3f810cf850bcdf0",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/contract-version-route": {
      "post": {
        "operationId": "x402_contract_version_route",
        "summary": "Declared contract migration route",
        "description": "Choose a bounded minimum-cost route through a supplied directed version-migration manifest, respecting explicit lossy-step, cost and step limits. Version IDs are opaque; no migrations run and declared compatibility is not independently verified.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/contract-version-route.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Plan a declared contract migration path between agent versions",
            "Find a lowest-cost adapter chain without allowing declared data loss"
          ],
          "whenToUse": [
            "Plan a declared contract migration path between agent versions",
            "Find a lowest-cost adapter chain without allowing declared data loss"
          ],
          "whenNotToUse": [
            "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution",
            "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees",
            "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness"
          ],
          "capabilities": [
            "Bounded dynamic programming over supplied directed edges, including cycles",
            "Lowest cost, then fewest steps, then exact lexicographic migration IDs",
            "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "migrations": 256,
            "distinctVersions": 128,
            "maximumSteps": 32
          },
          "related": [
            "contract-capability-negotiate",
            "json-schema-compatibility"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "VERSION_LIMIT",
            "ITEM_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "contract": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "sourceVersion": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "targetVersions": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  },
                  "migrations": {
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "from": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "to": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "costUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000
                        },
                        "lossy": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "id",
                        "from",
                        "to",
                        "costUnits",
                        "lossy"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "allowLossy": {
                    "type": "boolean"
                  },
                  "maximumCostUnits": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000000
                  },
                  "maximumSteps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 32
                  }
                },
                "required": [
                  "contract",
                  "sourceVersion",
                  "targetVersions",
                  "migrations",
                  "allowLossy",
                  "maximumCostUnits",
                  "maximumSteps"
                ],
                "additionalProperties": false
              },
              "example": {
                "contract": "task-record",
                "sourceVersion": "v1",
                "targetVersions": [
                  "v3"
                ],
                "migrations": [
                  {
                    "id": "one-two",
                    "from": "v1",
                    "to": "v2",
                    "costUnits": 2,
                    "lossy": false
                  },
                  {
                    "id": "two-three",
                    "from": "v2",
                    "to": "v3",
                    "costUnits": 3,
                    "lossy": false
                  }
                ],
                "allowLossy": false,
                "maximumCostUnits": 10,
                "maximumSteps": 4
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "contract-version-route",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "declared-contract-route-v1"
                        },
                        "contract": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "manifestValid": {
                          "type": "boolean"
                        },
                        "routeFound": {
                          "type": "boolean"
                        },
                        "route": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "targetVersion": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "costUnits": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "migrationIds": {
                                  "maxItems": 32,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  }
                                },
                                "versions": {
                                  "minItems": 1,
                                  "maxItems": 33,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  }
                                },
                                "containsLossyStep": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "targetVersion",
                                "costUnits",
                                "migrationIds",
                                "versions",
                                "containsLossyStep"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "selectionPolicy": {
                          "type": "string",
                          "const": "lowest-cost-then-fewest-steps-then-lexicographic-migration-ids"
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "contract",
                        "manifestValid",
                        "routeFound",
                        "route",
                        "selectionPolicy",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated",
                        "advisoryOnly",
                        "execution",
                        "authorizationGranted"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "contract-version-route",
                  "version": "0.29.0",
                  "result": {
                    "profile": "declared-contract-route-v1",
                    "contract": "task-record",
                    "manifestValid": true,
                    "routeFound": true,
                    "route": {
                      "targetVersion": "v3",
                      "costUnits": 5,
                      "migrationIds": [
                        "one-two",
                        "two-three"
                      ],
                      "versions": [
                        "v1",
                        "v2",
                        "v3"
                      ],
                      "containsLossyStep": false
                    },
                    "selectionPolicy": "lowest-cost-then-fewest-steps-then-lexicographic-migration-ids",
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false,
                    "advisoryOnly": true,
                    "execution": false,
                    "authorizationGranted": false
                  },
                  "provenance": {
                    "inputSha256": "60660389c7f5faa2d281b5746c520fe91095b938f9a171d927d7a9bdaf2c3837",
                    "outputSha256": "452b5e31f3af797da7880d0a594c7262ca6af4602c3241c4601e3e68ff18a7d3",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/message-batch-plan": {
      "post": {
        "operationId": "x402_message_batch_plan",
        "summary": "Message batch contiguous-prefix plan",
        "description": "Inspect up to 256 supplied message envelopes against stream checkpoints, explicit duplicate rules and sequence-slot identity. Propose a contiguous ordered prefix per stream, stopping at gaps and withholding every plan on structural conflicts. No messages are delivered or consumed.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/message-batch-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Order an agent message batch without skipping missing sequence numbers",
            "Deduplicate identical message envelopes under an explicit policy"
          ],
          "whenToUse": [
            "Order an agent message batch without skipping missing sequence numbers",
            "Deduplicate identical message envelopes under an explicit policy"
          ],
          "whenNotToUse": [
            "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution",
            "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees",
            "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness"
          ],
          "capabilities": [
            "Exact message-ID and stream-sequence conflict detection",
            "All-or-nothing conflict handling; independent stream prefixes stop at gaps",
            "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "streams": 32,
            "messages": 256
          },
          "related": [
            "causal-log-check",
            "checkpoint-handoff-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "VERSION_LIMIT",
            "ITEM_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "streams": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "nextSequence": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "id",
                        "nextSequence"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "messages": {
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "stream": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "sequence": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740990
                        },
                        "contentSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        }
                      },
                      "required": [
                        "id",
                        "stream",
                        "sequence",
                        "contentSha256"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "duplicatePolicy": {
                    "type": "string",
                    "enum": [
                      "keep-first-identical",
                      "reject"
                    ]
                  }
                },
                "required": [
                  "streams",
                  "messages",
                  "duplicatePolicy"
                ],
                "additionalProperties": false
              },
              "example": {
                "streams": [
                  {
                    "id": "jobs",
                    "nextSequence": 4
                  }
                ],
                "duplicatePolicy": "keep-first-identical",
                "messages": [
                  {
                    "id": "m5",
                    "stream": "jobs",
                    "sequence": 5,
                    "contentSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
                  },
                  {
                    "id": "m4",
                    "stream": "jobs",
                    "sequence": 4,
                    "contentSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "message-batch-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "message-batch-contiguous-prefix-v1"
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "allRemainingMessagesSelected": {
                          "type": "boolean"
                        },
                        "plans": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "stream": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "messageIds": {
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              },
                              "inputIndices": {
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "nextSequence": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "gapAt": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "stream",
                              "messageIds",
                              "inputIndices",
                              "nextSequence",
                              "gapAt"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "dispositions": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "messageId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "disposition": {
                                "type": "string",
                                "enum": [
                                  "selected",
                                  "exact_duplicate",
                                  "before_checkpoint",
                                  "blocked_gap",
                                  "conflict",
                                  "unknown_stream",
                                  "held_invalid_batch"
                                ]
                              }
                            },
                            "required": [
                              "inputIndex",
                              "messageId",
                              "disposition"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "orderingPolicy": {
                          "type": "string",
                          "const": "input-stream-order-then-ascending-sequence"
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "consistent",
                        "allRemainingMessagesSelected",
                        "plans",
                        "dispositions",
                        "orderingPolicy",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated",
                        "advisoryOnly",
                        "execution",
                        "authorizationGranted"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "message-batch-plan",
                  "version": "0.29.0",
                  "result": {
                    "profile": "message-batch-contiguous-prefix-v1",
                    "consistent": true,
                    "allRemainingMessagesSelected": true,
                    "plans": [
                      {
                        "stream": "jobs",
                        "messageIds": [
                          "m4",
                          "m5"
                        ],
                        "inputIndices": [
                          1,
                          0
                        ],
                        "nextSequence": 6,
                        "gapAt": null
                      }
                    ],
                    "dispositions": [
                      {
                        "inputIndex": 0,
                        "messageId": "m5",
                        "disposition": "selected"
                      },
                      {
                        "inputIndex": 1,
                        "messageId": "m4",
                        "disposition": "selected"
                      }
                    ],
                    "orderingPolicy": "input-stream-order-then-ascending-sequence",
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false,
                    "advisoryOnly": true,
                    "execution": false,
                    "authorizationGranted": false
                  },
                  "provenance": {
                    "inputSha256": "476b2632476a1d18051d6e887e497daa163a23f2f23b75c700f3244df1b9ce5e",
                    "outputSha256": "d148b30c422eb8c1f665e97e9aa41814ac5be288467d671637bfa33cea57eedf",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/pagination-chain-check": {
      "post": {
        "operationId": "x402_pagination_chain_check",
        "summary": "Pagination snapshot-chain check",
        "description": "Validate a supplied page chain for consecutive numbers, cursor continuity and cycles, fixed snapshot/query digests, and item-ID/content conflicts. Return a checkpoint only for a consistent chain. A terminal marker is not proof of a complete live dataset.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/pagination-chain-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Check pagination cursor continuity before handing a checkpoint to another agent",
            "Detect snapshot drift and repeated records in captured API pages"
          ],
          "whenToUse": [
            "Check pagination cursor continuity before handing a checkpoint to another agent",
            "Detect snapshot drift and repeated records in captured API pages"
          ],
          "whenNotToUse": [
            "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution",
            "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees",
            "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness"
          ],
          "capabilities": [
            "Exact opaque cursor chaining with explicit null terminal markers",
            "Supplied item digests and explicit duplicate-item policy; no page fetching",
            "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "pages": 128,
            "itemsPerPage": 256,
            "totalItems": 512,
            "cursorCharacters": 256
          },
          "related": [
            "checkpoint-handoff-check",
            "http-link-parse"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "VERSION_LIMIT",
            "ITEM_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "snapshotId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "querySha256": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$"
                  },
                  "startCursor": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "firstPageNumber": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740863
                  },
                  "duplicateItemPolicy": {
                    "type": "string",
                    "enum": [
                      "reject",
                      "allow-identical"
                    ]
                  },
                  "pages": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "pageNumber": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "requestCursor": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "nextCursor": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "snapshotId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "querySha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "items": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "contentSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              }
                            },
                            "required": [
                              "id",
                              "contentSha256"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "pageNumber",
                        "requestCursor",
                        "nextCursor",
                        "snapshotId",
                        "querySha256",
                        "items"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "snapshotId",
                  "querySha256",
                  "startCursor",
                  "firstPageNumber",
                  "duplicateItemPolicy",
                  "pages"
                ],
                "additionalProperties": false
              },
              "example": {
                "snapshotId": "snapshot-1",
                "querySha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "startCursor": null,
                "firstPageNumber": 0,
                "duplicateItemPolicy": "reject",
                "pages": [
                  {
                    "pageNumber": 0,
                    "requestCursor": null,
                    "nextCursor": "page-two",
                    "snapshotId": "snapshot-1",
                    "querySha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                    "items": [
                      {
                        "id": "item-1",
                        "contentSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "pagination-chain-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "pagination-chain-snapshot-v1"
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "pageCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "itemCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "uniqueItemCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "terminalObserved": {
                          "type": "boolean"
                        },
                        "checkpoint": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "snapshotId": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "querySha256": {
                                  "type": "string",
                                  "pattern": "^[a-f0-9]{64}$"
                                },
                                "nextPageNumber": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "nextCursor": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 256
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "terminal": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "snapshotId",
                                "querySha256",
                                "nextPageNumber",
                                "nextCursor",
                                "terminal"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "consistent",
                        "pageCount",
                        "itemCount",
                        "uniqueItemCount",
                        "terminalObserved",
                        "checkpoint",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated",
                        "advisoryOnly",
                        "execution",
                        "authorizationGranted"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "pagination-chain-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "pagination-chain-snapshot-v1",
                    "consistent": true,
                    "pageCount": 1,
                    "itemCount": 1,
                    "uniqueItemCount": 1,
                    "terminalObserved": false,
                    "checkpoint": {
                      "snapshotId": "snapshot-1",
                      "querySha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                      "nextPageNumber": 1,
                      "nextCursor": "page-two",
                      "terminal": false
                    },
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false,
                    "advisoryOnly": true,
                    "execution": false,
                    "authorizationGranted": false
                  },
                  "provenance": {
                    "inputSha256": "3355a2862c59019a9c2b5d9e859914e0cd3e228f852a68042ebf0054abf20ebe",
                    "outputSha256": "207f2a322c2aea3db1cad8d10b6ca29dffbfe4726773165c8e0907226f4e24eb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/artifact-lineage-check": {
      "post": {
        "operationId": "x402_artifact_lineage_check",
        "summary": "Artifact derivation lineage check",
        "description": "Check a supplied artifact derivation graph for parent-digest and media-type agreement, missing or cyclic ancestry, and required/forbidden ancestor or depth constraints. Inspect only supplied manifests; no artifact bytes, derivations, identities or source authenticity are verified.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/artifact-lineage-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate artifact parent digests and transformation media contracts",
            "Check required or forbidden source ancestry before accepting an agent artifact"
          ],
          "whenToUse": [
            "Validate artifact parent digests and transformation media contracts",
            "Check required or forbidden source ancestry before accepting an agent artifact"
          ],
          "whenNotToUse": [
            "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution",
            "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees",
            "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness"
          ],
          "capabilities": [
            "Derived/source distinction and exact digest/type checks across edges",
            "Transitive ancestor constraints, roots and longest chain depth on valid graphs",
            "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "artifacts": 128,
            "parentsPerArtifact": 16,
            "targets": 32,
            "ancestorsPerConstraint": 32
          },
          "related": [
            "artifact-manifest-check",
            "workflow-dag-analyze"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "VERSION_LIMIT",
            "ITEM_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "artifacts": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "source",
                            "derived"
                          ]
                        },
                        "mediaType": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "parents": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "expectedSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              }
                            },
                            "required": [
                              "id",
                              "expectedSha256"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "derivation": {
                          "type": "object",
                          "properties": {
                            "operation": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "version": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "inputMediaTypes": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "outputMediaType": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            }
                          },
                          "required": [
                            "operation",
                            "version",
                            "inputMediaTypes",
                            "outputMediaType"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "id",
                        "sha256",
                        "kind",
                        "mediaType",
                        "parents"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "targets": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "artifactId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "expectedSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "requiredAncestors": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "forbiddenAncestors": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "maximumDepth": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 127
                        }
                      },
                      "required": [
                        "artifactId",
                        "requiredAncestors",
                        "forbiddenAncestors",
                        "maximumDepth"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "artifacts",
                  "targets"
                ],
                "additionalProperties": false
              },
              "example": {
                "artifacts": [
                  {
                    "id": "source",
                    "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                    "kind": "source",
                    "mediaType": "text/plain",
                    "parents": []
                  },
                  {
                    "id": "summary",
                    "sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "kind": "derived",
                    "mediaType": "application/json",
                    "parents": [
                      {
                        "id": "source",
                        "expectedSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
                      }
                    ],
                    "derivation": {
                      "operation": "extract",
                      "version": "1",
                      "inputMediaTypes": [
                        "text/plain"
                      ],
                      "outputMediaType": "application/json"
                    }
                  }
                ],
                "targets": [
                  {
                    "artifactId": "summary",
                    "expectedSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "requiredAncestors": [
                      "source"
                    ],
                    "forbiddenAncestors": [],
                    "maximumDepth": 2
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "artifact-lineage-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "artifact-derivation-lineage-v1"
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "targets": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "artifactId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "matchesRequirements": {
                                "type": "boolean"
                              },
                              "ancestors": {
                                "maxItems": 127,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              },
                              "rootSources": {
                                "maxItems": 128,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              },
                              "depth": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "completeSuppliedLineage": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "artifactId",
                              "matchesRequirements",
                              "ancestors",
                              "rootSources",
                              "depth",
                              "completeSuppliedLineage"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "consistent",
                        "targets",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated",
                        "advisoryOnly",
                        "execution",
                        "authorizationGranted"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "artifact-lineage-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "artifact-derivation-lineage-v1",
                    "consistent": true,
                    "targets": [
                      {
                        "artifactId": "summary",
                        "matchesRequirements": true,
                        "ancestors": [
                          "source"
                        ],
                        "rootSources": [
                          "source"
                        ],
                        "depth": 1,
                        "completeSuppliedLineage": true
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false,
                    "advisoryOnly": true,
                    "execution": false,
                    "authorizationGranted": false
                  },
                  "provenance": {
                    "inputSha256": "507af5b7f2bc18266841de2aad66dd74e0e46d7281b89d47ccc6c5e05c8c4882",
                    "outputSha256": "f67df918a8b3a3f449b877066a50d72013446c94a2e48a1c9d6f42ee9fefd167",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/numeric-rounding-check": {
      "post": {
        "operationId": "x402_numeric_rounding_check",
        "summary": "Exact numeric rounding check",
        "description": "Check explicitly supplied decimal claims against five declared decimal-place rounding rules. Returns exact expected text, tie evidence and rational errors; no number extraction, unit inference or fact verification.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/numeric-rounding-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Check rounding consistency in an agent-generated numeric report",
            "Audit exact decimal tie handling without binary floating-point artifacts"
          ],
          "whenToUse": [
            "Check rounding consistency in an agent-generated numeric report",
            "Audit exact decimal tie handling without binary floating-point artifacts"
          ],
          "whenNotToUse": [
            "Extracting facts or judging truth, semantic correctness, evidence authenticity, causal effects, or production readiness",
            "Fetching data, executing models or user code, changing datasets, authorizing actions, or contacting live services",
            "Inferring population quality, statistical significance, uncertainty intervals, or generalization from a supplied sample"
          ],
          "capabilities": [
            "exact-decimal-rounding-v1 profile",
            "Exact decimal strings; half-even, half-away-from-zero, toward-zero, floor and ceiling",
            "Claim equality is numeric, not formatting equality; rational signed discrepancy and absolute rounding error",
            "Networkless supplied-evidence computation; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "claims": 200,
            "decimalPlaces": "0–18",
            "claimedIntegerDigits": 25
          },
          "related": [
            "units-convert",
            "interval-analyze"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_RULE",
            "DUPLICATE_ID",
            "UNKNOWN_CRITERION",
            "RECORD_LIMIT",
            "NUMERIC_COMPLEXITY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "claims": {
                    "minItems": 1,
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "source": {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                        },
                        "claimed": {
                          "type": "string",
                          "maxLength": 45,
                          "pattern": "^-?(?:0|[1-9]\\d{0,24})(?:\\.\\d{1,18})?$",
                          "description": "Exact claimed decimal; up to 25 integer digits to accommodate source rounding carry, and 18 fractional digits."
                        },
                        "decimalPlaces": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 18
                        },
                        "mode": {
                          "type": "string",
                          "enum": [
                            "half-even",
                            "half-away-from-zero",
                            "toward-zero",
                            "floor",
                            "ceiling"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "source",
                        "claimed",
                        "decimalPlaces",
                        "mode"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "claims"
                ],
                "additionalProperties": false
              },
              "example": {
                "claims": [
                  {
                    "id": "reported-rate",
                    "source": "1.245",
                    "claimed": "1.25",
                    "decimalPlaces": 2,
                    "mode": "half-even"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "numeric-rounding-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "exact-decimal-rounding-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "checkedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "mismatchCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "claims": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "consistent": {
                                "type": "boolean"
                              },
                              "expected": {
                                "type": "string",
                                "maxLength": 64
                              },
                              "claimedMinusExpected": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 2049,
                                    "pattern": "^-?(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 2048,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "absoluteRoundingError": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 2049,
                                    "pattern": "^-?(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 2048,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "exact": {
                                "type": "boolean"
                              },
                              "tie": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "id",
                              "consistent",
                              "expected",
                              "claimedMinusExpected",
                              "absoluteRoundingError",
                              "exact",
                              "tie"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "semanticValidityVerified",
                        "consistent",
                        "checkedCount",
                        "mismatchCount",
                        "claims"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "numeric-rounding-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-decimal-rounding-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "semanticValidityVerified": false,
                    "consistent": false,
                    "checkedCount": 1,
                    "mismatchCount": 1,
                    "claims": [
                      {
                        "id": "reported-rate",
                        "consistent": false,
                        "expected": "1.24",
                        "claimedMinusExpected": {
                          "numerator": "1",
                          "denominator": "100"
                        },
                        "absoluteRoundingError": {
                          "numerator": "1",
                          "denominator": "200"
                        },
                        "exact": false,
                        "tie": true
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "2da0fae2a30e8eef6a180e1763cd895c4824e08ba9556b32cc202086910ff43e",
                    "outputSha256": "8883a6ae66f0b6b32c704129b98492523391975e090ed6e75e68e2e05de68a27",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/rubric-score-aggregate": {
      "post": {
        "operationId": "x402_rubric_score_aggregate",
        "summary": "Missingness-aware rubric aggregation",
        "description": "Aggregate supplied weighted rubric scores with exact normalized fractions and conservative lower/upper bounds for missing ratings. Optional threshold reports certain pass, certain fail or unknown; does not assign ratings or renormalize away missing criteria.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/rubric-score-aggregate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Aggregate an explicit agent evaluation rubric without hiding missing scores",
            "Determine whether omitted rubric ratings can change a supplied pass threshold"
          ],
          "whenToUse": [
            "Aggregate an explicit agent evaluation rubric without hiding missing scores",
            "Determine whether omitted rubric ratings can change a supplied pass threshold"
          ],
          "whenNotToUse": [
            "Extracting facts or judging truth, semantic correctness, evidence authenticity, causal effects, or production readiness",
            "Fetching data, executing models or user code, changing datasets, authorizing actions, or contacting live services",
            "Inferring population quality, statistical significance, uncertainty intervals, or generalization from a supplied sample"
          ],
          "capabilities": [
            "bounded-rubric-aggregation-v1 profile",
            "Positive exact weights; score/maxScore normalization; full-weight denominator",
            "Missing scores span zero to maximum; exact score remains null until complete",
            "Networkless supplied-evidence computation; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "criteria": 100,
            "ratings": 100,
            "maxScore": "positive safe integer at most 1,000,000"
          },
          "related": [
            "classification-evaluate",
            "metric-regression-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_RULE",
            "DUPLICATE_ID",
            "UNKNOWN_CRITERION",
            "RECORD_LIMIT",
            "NUMERIC_COMPLEXITY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "criteria": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "weight": {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                        },
                        "maxScore": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000
                        }
                      },
                      "required": [
                        "id",
                        "weight",
                        "maxScore"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "ratings": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "criterionId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "score": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 44,
                              "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                              "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "criterionId",
                        "score"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "passThreshold": {
                    "type": "string",
                    "maxLength": 44,
                    "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                    "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                  }
                },
                "required": [
                  "criteria",
                  "ratings"
                ],
                "additionalProperties": false
              },
              "example": {
                "criteria": [
                  {
                    "id": "correctness",
                    "weight": "3",
                    "maxScore": 5
                  },
                  {
                    "id": "completeness",
                    "weight": "1",
                    "maxScore": 5
                  }
                ],
                "ratings": [
                  {
                    "criterionId": "correctness",
                    "score": "4"
                  }
                ],
                "passThreshold": "0.8"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "rubric-score-aggregate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "bounded-rubric-aggregation-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "complete": {
                          "type": "boolean"
                        },
                        "criterionCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "ratedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "missingCriterionIds": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "totalWeight": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "observedWeight": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "observedWeightFraction": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "score": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "lowerBound": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "upperBound": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "threshold": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "thresholdStatus": {
                          "type": "string",
                          "enum": [
                            "passed",
                            "failed",
                            "unknown",
                            "not_requested"
                          ]
                        },
                        "criteria": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "rated",
                                  "missing"
                                ]
                              },
                              "normalizedScore": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "weightedContribution": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "status",
                              "normalizedScore",
                              "weightedContribution"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "semanticValidityVerified",
                        "complete",
                        "criterionCount",
                        "ratedCount",
                        "missingCriterionIds",
                        "totalWeight",
                        "observedWeight",
                        "observedWeightFraction",
                        "score",
                        "lowerBound",
                        "upperBound",
                        "threshold",
                        "thresholdStatus",
                        "criteria"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "rubric-score-aggregate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "bounded-rubric-aggregation-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "semanticValidityVerified": false,
                    "complete": false,
                    "criterionCount": 2,
                    "ratedCount": 1,
                    "missingCriterionIds": [
                      "completeness"
                    ],
                    "totalWeight": {
                      "numerator": "4",
                      "denominator": "1"
                    },
                    "observedWeight": {
                      "numerator": "3",
                      "denominator": "1"
                    },
                    "observedWeightFraction": {
                      "numerator": "3",
                      "denominator": "4"
                    },
                    "score": null,
                    "lowerBound": {
                      "numerator": "3",
                      "denominator": "5"
                    },
                    "upperBound": {
                      "numerator": "17",
                      "denominator": "20"
                    },
                    "threshold": {
                      "numerator": "4",
                      "denominator": "5"
                    },
                    "thresholdStatus": "unknown",
                    "criteria": [
                      {
                        "id": "correctness",
                        "status": "rated",
                        "normalizedScore": {
                          "numerator": "4",
                          "denominator": "5"
                        },
                        "weightedContribution": {
                          "numerator": "12",
                          "denominator": "5"
                        }
                      },
                      {
                        "id": "completeness",
                        "status": "missing",
                        "normalizedScore": null,
                        "weightedContribution": null
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "45069751e8b836c12a37d9ea034ccde629e808399600b9febcd60bbf996804ac",
                    "outputSha256": "26c2563fe2e5c4094cb9eb65f344987cb0758eaa7939797d4f372bff4e149f10",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/dataset-split-audit": {
      "post": {
        "operationId": "x402_dataset_split_audit",
        "summary": "Declared dataset split overlap audit",
        "description": "Find exact item ID, group ID and supplied SHA-256 fingerprint overlaps across caller-declared dataset partitions. Reports missing identity coverage and capped locations; no data fetching, hash verification, near-duplicate detection or proof of leakage-free evaluation.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/dataset-split-audit.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find exact train validation test overlap from supplied IDs and group keys",
            "Audit group leakage candidates before an agent evaluation run"
          ],
          "whenToUse": [
            "Find exact train validation test overlap from supplied IDs and group keys",
            "Audit group leakage candidates before an agent evaluation run"
          ],
          "whenNotToUse": [
            "Extracting facts or judging truth, semantic correctness, evidence authenticity, causal effects, or production readiness",
            "Fetching data, executing models or user code, changing datasets, authorizing actions, or contacting live services",
            "Inferring population quality, statistical significance, uncertainty intervals, or generalization from a supplied sample"
          ],
          "capabilities": [
            "declared-dataset-split-v1 profile",
            "Exact case-sensitive item/group/fingerprint equality across named partitions",
            "Counts retain full bounded evidence totals; at most 200 evidence groups and eight locations each",
            "Networkless supplied-evidence computation; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "partitions": 16,
            "totalRecords": 1000,
            "locationsPerEvidence": 8
          },
          "related": [
            "record-relations",
            "record-profile"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_RULE",
            "DUPLICATE_ID",
            "UNKNOWN_CRITERION",
            "RECORD_LIMIT",
            "NUMERIC_COMPLEXITY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "partitions": {
                    "minItems": 2,
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "records": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "itemId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "groupId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "fingerprint": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              }
                            },
                            "required": [
                              "itemId"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "records"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "partitions"
                ],
                "additionalProperties": false
              },
              "example": {
                "partitions": [
                  {
                    "id": "train",
                    "records": [
                      {
                        "itemId": "row-1",
                        "groupId": "conversation-a"
                      }
                    ]
                  },
                  {
                    "id": "test",
                    "records": [
                      {
                        "itemId": "row-2",
                        "groupId": "conversation-a"
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "dataset-split-audit",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "declared-dataset-split-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "overlap_detected",
                            "no_observed_overlap"
                          ]
                        },
                        "recordCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "partitionCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "crossPartitionValueCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "duplicateIdentityValueCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "evidenceTruncated": {
                          "type": "boolean"
                        },
                        "dimensions": {
                          "minItems": 3,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "field": {
                                "type": "string",
                                "enum": [
                                  "itemId",
                                  "groupId",
                                  "fingerprint"
                                ]
                              },
                              "suppliedCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "missingCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "distinctValueCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "crossPartitionValueCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "withinPartitionDuplicateValueCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "field",
                              "suppliedCount",
                              "missingCount",
                              "distinctValueCount",
                              "crossPartitionValueCount",
                              "withinPartitionDuplicateValueCount"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "evidence": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "field": {
                                "type": "string",
                                "enum": [
                                  "itemId",
                                  "groupId",
                                  "fingerprint"
                                ]
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "cross_partition",
                                  "within_partition_duplicate"
                                ]
                              },
                              "partitions": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              },
                              "recordCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "locations": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "partitionId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    "recordIndex": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "partitionId",
                                    "recordIndex"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "locationsTruncated": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "field",
                              "value",
                              "kind",
                              "partitions",
                              "recordCount",
                              "locations",
                              "locationsTruncated"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "semanticValidityVerified",
                        "status",
                        "recordCount",
                        "partitionCount",
                        "crossPartitionValueCount",
                        "duplicateIdentityValueCount",
                        "evidenceTruncated",
                        "dimensions",
                        "evidence"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "dataset-split-audit",
                  "version": "0.29.0",
                  "result": {
                    "profile": "declared-dataset-split-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "semanticValidityVerified": false,
                    "status": "overlap_detected",
                    "recordCount": 2,
                    "partitionCount": 2,
                    "crossPartitionValueCount": 1,
                    "duplicateIdentityValueCount": 0,
                    "evidenceTruncated": false,
                    "dimensions": [
                      {
                        "field": "itemId",
                        "suppliedCount": 2,
                        "missingCount": 0,
                        "distinctValueCount": 2,
                        "crossPartitionValueCount": 0,
                        "withinPartitionDuplicateValueCount": 0
                      },
                      {
                        "field": "groupId",
                        "suppliedCount": 2,
                        "missingCount": 0,
                        "distinctValueCount": 1,
                        "crossPartitionValueCount": 1,
                        "withinPartitionDuplicateValueCount": 0
                      },
                      {
                        "field": "fingerprint",
                        "suppliedCount": 0,
                        "missingCount": 2,
                        "distinctValueCount": 0,
                        "crossPartitionValueCount": 0,
                        "withinPartitionDuplicateValueCount": 0
                      }
                    ],
                    "evidence": [
                      {
                        "field": "groupId",
                        "value": "conversation-a",
                        "kind": "cross_partition",
                        "partitions": [
                          "test",
                          "train"
                        ],
                        "recordCount": 2,
                        "locations": [
                          {
                            "partitionId": "train",
                            "recordIndex": 0
                          },
                          {
                            "partitionId": "test",
                            "recordIndex": 0
                          }
                        ],
                        "locationsTruncated": false
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "c8e7bbf2610fd939ea9da8f874a37291d4ae5a8974620b50c21c85ee55ccf176",
                    "outputSha256": "acc76f8ae28f14ba1a38a39e21620cfb14d5addd64337ee522bf5c7c5c81f6bb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/metric-regression-check": {
      "post": {
        "operationId": "x402_metric_regression_check",
        "summary": "Exact metric regression budget check",
        "description": "Compare supplied baseline/candidate decimal measurements against explicit directional absolute and relative regression budgets. Missing values stay unknown; every configured budget must pass. No benchmarking, unit conversion, noise model or significance test.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/metric-regression-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Gate supplied agent benchmark changes against explicit regression budgets",
            "Compare baseline and candidate measurements while preserving missing evidence"
          ],
          "whenToUse": [
            "Gate supplied agent benchmark changes against explicit regression budgets",
            "Compare baseline and candidate measurements while preserving missing evidence"
          ],
          "whenNotToUse": [
            "Extracting facts or judging truth, semantic correctness, evidence authenticity, causal effects, or production readiness",
            "Fetching data, executing models or user code, changing datasets, authorizing actions, or contacting live services",
            "Inferring population quality, statistical significance, uncertainty intervals, or generalization from a supplied sample"
          ],
          "capabilities": [
            "exact-metric-regression-v1 profile",
            "All configured budgets must hold; relative limit is abs(baseline) times ratio",
            "Zero baseline yields null relative ratio and zero relative allowance; improvements have zero degradation",
            "Networkless supplied-evidence computation; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "metrics": 200
          },
          "related": [
            "rubric-score-aggregate",
            "replay-divergence-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_RULE",
            "DUPLICATE_ID",
            "UNKNOWN_CRITERION",
            "RECORD_LIMIT",
            "NUMERIC_COMPLEXITY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "metrics": {
                    "minItems": 1,
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "unit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "direction": {
                          "type": "string",
                          "enum": [
                            "lower_is_better",
                            "higher_is_better"
                          ]
                        },
                        "baseline": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 44,
                              "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                              "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "candidate": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 44,
                              "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                              "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "maxAbsoluteRegression": {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                        },
                        "maxRelativeRegression": {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                        }
                      },
                      "required": [
                        "id",
                        "unit",
                        "direction",
                        "baseline",
                        "candidate"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "metrics"
                ],
                "additionalProperties": false
              },
              "example": {
                "metrics": [
                  {
                    "id": "p95-latency",
                    "unit": "ms",
                    "direction": "lower_is_better",
                    "baseline": "100",
                    "candidate": "106",
                    "maxAbsoluteRegression": "10",
                    "maxRelativeRegression": "0.05"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "metric-regression-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "exact-metric-regression-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "passed",
                            "failed",
                            "unknown"
                          ]
                        },
                        "passedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "failedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "unknownCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "metrics": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "unit": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "passed",
                                  "failed",
                                  "unknown"
                                ]
                              },
                              "missing": {
                                "maxItems": 2,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "baseline",
                                    "candidate"
                                  ]
                                }
                              },
                              "delta": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "degradation": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "relativeDegradation": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "zeroBaseline": {
                                "type": [
                                  "boolean",
                                  "null"
                                ]
                              },
                              "absoluteBudget": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "limit": {
                                        "type": "object",
                                        "properties": {
                                          "numerator": {
                                            "type": "string",
                                            "maxLength": 2049,
                                            "pattern": "^-?(?:0|[1-9]\\d*)$"
                                          },
                                          "denominator": {
                                            "type": "string",
                                            "maxLength": 2048,
                                            "pattern": "^[1-9]\\d*$"
                                          }
                                        },
                                        "required": [
                                          "numerator",
                                          "denominator"
                                        ],
                                        "additionalProperties": false
                                      },
                                      "withinBudget": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "limit",
                                      "withinBudget"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "relativeBudget": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "limit": {
                                        "type": "object",
                                        "properties": {
                                          "numerator": {
                                            "type": "string",
                                            "maxLength": 2049,
                                            "pattern": "^-?(?:0|[1-9]\\d*)$"
                                          },
                                          "denominator": {
                                            "type": "string",
                                            "maxLength": 2048,
                                            "pattern": "^[1-9]\\d*$"
                                          }
                                        },
                                        "required": [
                                          "numerator",
                                          "denominator"
                                        ],
                                        "additionalProperties": false
                                      },
                                      "withinBudget": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "limit",
                                      "withinBudget"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "unit",
                              "status",
                              "missing",
                              "delta",
                              "degradation",
                              "relativeDegradation",
                              "zeroBaseline",
                              "absoluteBudget",
                              "relativeBudget"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "semanticValidityVerified",
                        "status",
                        "passedCount",
                        "failedCount",
                        "unknownCount",
                        "metrics"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "metric-regression-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-metric-regression-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "semanticValidityVerified": false,
                    "status": "failed",
                    "passedCount": 0,
                    "failedCount": 1,
                    "unknownCount": 0,
                    "metrics": [
                      {
                        "id": "p95-latency",
                        "unit": "ms",
                        "status": "failed",
                        "missing": [],
                        "delta": {
                          "numerator": "6",
                          "denominator": "1"
                        },
                        "degradation": {
                          "numerator": "6",
                          "denominator": "1"
                        },
                        "relativeDegradation": {
                          "numerator": "3",
                          "denominator": "50"
                        },
                        "zeroBaseline": false,
                        "absoluteBudget": {
                          "limit": {
                            "numerator": "10",
                            "denominator": "1"
                          },
                          "withinBudget": true
                        },
                        "relativeBudget": {
                          "limit": {
                            "numerator": "5",
                            "denominator": "1"
                          },
                          "withinBudget": false
                        }
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "91ca7032db19ed1509a034d76d4207e3a4816fdd2f1d8685772fae5e8d95c91a",
                    "outputSha256": "d3723d6e6614497e8f659f57baacc4bddc88d08396961c3a9d526f374f0a6c7d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/prediction-calibration-check": {
      "post": {
        "operationId": "x402_prediction_calibration_check",
        "summary": "Supplied binary probability calibration",
        "description": "Compute exact binary Brier score and uniform-bin calibration diagnostics from supplied probabilities and nullable Boolean outcomes. Reports label coverage and per-row errors; no learned calibration, confidence intervals, forecast validity or population-quality claim.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/prediction-calibration-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Evaluate supplied agent confidence probabilities against binary outcomes",
            "Inspect Brier error and reliability bins without dropping unknown labels silently"
          ],
          "whenToUse": [
            "Evaluate supplied agent confidence probabilities against binary outcomes",
            "Inspect Brier error and reliability bins without dropping unknown labels silently"
          ],
          "whenNotToUse": [
            "Extracting facts or judging truth, semantic correctness, evidence authenticity, causal effects, or production readiness",
            "Fetching data, executing models or user code, changing datasets, authorizing actions, or contacting live services",
            "Inferring population quality, statistical significance, uncertainty intervals, or generalization from a supplied sample"
          ],
          "capabilities": [
            "binary-probability-calibration-v1 profile",
            "Binary Brier mean (p-y)^2, count-weighted absolute bin gap and maximum nonempty-bin gap",
            "Uniform [lower,upper) bins with final upper inclusive; labeled-only metrics and explicit unknown counts",
            "Networkless supplied-evidence computation; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "predictions": 1000,
            "binCount": "1–20"
          },
          "related": [
            "classification-evaluate",
            "metric-regression-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_RULE",
            "DUPLICATE_ID",
            "UNKNOWN_CRITERION",
            "RECORD_LIMIT",
            "NUMERIC_COMPLEXITY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "predictions": {
                    "minItems": 1,
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "probability": {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                        },
                        "outcome": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "probability",
                        "outcome"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "binCount": {
                    "default": 10,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20
                  }
                },
                "required": [
                  "predictions"
                ],
                "additionalProperties": false
              },
              "example": {
                "binCount": 2,
                "predictions": [
                  {
                    "id": "case-1",
                    "probability": "0.8",
                    "outcome": true
                  },
                  {
                    "id": "case-2",
                    "probability": "0.8",
                    "outcome": false
                  },
                  {
                    "id": "case-3",
                    "probability": "0.2",
                    "outcome": null
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "prediction-calibration-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "binary-probability-calibration-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "predictionCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "labeledCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "unknownOutcomeCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "complete": {
                          "type": "boolean"
                        },
                        "brierScore": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "expectedCalibrationError": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "maximumCalibrationGap": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "bins": {
                          "maxItems": 20,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "lowerInclusive": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 2049,
                                    "pattern": "^-?(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 2048,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "upper": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 2049,
                                    "pattern": "^-?(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 2048,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "upperInclusive": {
                                "type": "boolean"
                              },
                              "predictionCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "labeledCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "positiveCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "meanProbability": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "observedRate": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "calibrationGap": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "index",
                              "lowerInclusive",
                              "upper",
                              "upperInclusive",
                              "predictionCount",
                              "labeledCount",
                              "positiveCount",
                              "meanProbability",
                              "observedRate",
                              "calibrationGap"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "predictions": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "binIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "squaredError": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "binIndex",
                              "squaredError"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "semanticValidityVerified",
                        "predictionCount",
                        "labeledCount",
                        "unknownOutcomeCount",
                        "complete",
                        "brierScore",
                        "expectedCalibrationError",
                        "maximumCalibrationGap",
                        "bins",
                        "predictions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "prediction-calibration-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "binary-probability-calibration-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "semanticValidityVerified": false,
                    "predictionCount": 3,
                    "labeledCount": 2,
                    "unknownOutcomeCount": 1,
                    "complete": false,
                    "brierScore": {
                      "numerator": "17",
                      "denominator": "50"
                    },
                    "expectedCalibrationError": {
                      "numerator": "3",
                      "denominator": "10"
                    },
                    "maximumCalibrationGap": {
                      "numerator": "3",
                      "denominator": "10"
                    },
                    "bins": [
                      {
                        "index": 0,
                        "lowerInclusive": {
                          "numerator": "0",
                          "denominator": "1"
                        },
                        "upper": {
                          "numerator": "1",
                          "denominator": "2"
                        },
                        "upperInclusive": false,
                        "predictionCount": 1,
                        "labeledCount": 0,
                        "positiveCount": 0,
                        "meanProbability": null,
                        "observedRate": null,
                        "calibrationGap": null
                      },
                      {
                        "index": 1,
                        "lowerInclusive": {
                          "numerator": "1",
                          "denominator": "2"
                        },
                        "upper": {
                          "numerator": "1",
                          "denominator": "1"
                        },
                        "upperInclusive": true,
                        "predictionCount": 2,
                        "labeledCount": 2,
                        "positiveCount": 1,
                        "meanProbability": {
                          "numerator": "4",
                          "denominator": "5"
                        },
                        "observedRate": {
                          "numerator": "1",
                          "denominator": "2"
                        },
                        "calibrationGap": {
                          "numerator": "3",
                          "denominator": "10"
                        }
                      }
                    ],
                    "predictions": [
                      {
                        "id": "case-1",
                        "binIndex": 1,
                        "squaredError": {
                          "numerator": "1",
                          "denominator": "25"
                        }
                      },
                      {
                        "id": "case-2",
                        "binIndex": 1,
                        "squaredError": {
                          "numerator": "16",
                          "denominator": "25"
                        }
                      },
                      {
                        "id": "case-3",
                        "binIndex": 0,
                        "squaredError": null
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "487d8a324ebc4d910aa27e48d5abb89bb0c16022113f707bc6dc6c321cde07b4",
                    "outputSha256": "ec152f997950d908cbe1a00982c312bab17bb2f591623e4872555689c6013503",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/record-profile": {
      "post": {
        "operationId": "x402_record_profile",
        "summary": "Record field observations",
        "description": "Profile caller-selected JSON Pointer fields across up to 500 records: missing/null/type counts, typed distinct values, numeric bounds/median, UTF-16 string lengths and bounded duplicate-row evidence. Observations only; no inferred schema guarantee or population extrapolation.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/record-profile.md"
        },
        "x-agent-discovery": {
          "intents": [
            "profile missing null fields in JSON records",
            "inspect dataset types cardinality duplicates before validation",
            "measure field completeness and mixed types"
          ],
          "whenToUse": [
            "profile missing null fields in JSON records",
            "inspect dataset types cardinality duplicates before validation",
            "measure field completeness and mixed types"
          ],
          "whenNotToUse": [
            "Infer a guaranteed schema or population distribution",
            "Fuzzy entity matching or CSV file comparison"
          ],
          "capabilities": [
            "JSON Pointer field observations",
            "missing/null separation",
            "typed structural cardinality",
            "duplicate evidence",
            "numeric median"
          ],
          "related": [
            "record-constraints",
            "record-relations"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "records": 500,
            "fields": 32,
            "duplicateGroupsPerField": 5
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1record-profile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "fields": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 512,
                      "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                    }
                  }
                },
                "required": [
                  "records",
                  "fields"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1record-profile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1record-profile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "id": "a",
                    "price": 12,
                    "status": "ready"
                  },
                  {
                    "id": "b",
                    "price": null,
                    "status": "ready"
                  },
                  {
                    "id": "c",
                    "status": "new"
                  }
                ],
                "fields": [
                  "/price",
                  "/status"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "record-profile",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "record-observations-v1"
                        },
                        "rowCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "fields": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "presentCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "missingCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "nullCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "distinctCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "typeCounts": {
                                "type": "object",
                                "properties": {
                                  "null": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "boolean": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "number": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "string": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "array": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "object": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                },
                                "required": [
                                  "null",
                                  "boolean",
                                  "number",
                                  "string",
                                  "array",
                                  "object"
                                ],
                                "additionalProperties": false
                              },
                              "numeric": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "count": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "min": {
                                        "type": "number"
                                      },
                                      "max": {
                                        "type": "number"
                                      },
                                      "median": {
                                        "type": "number"
                                      }
                                    },
                                    "required": [
                                      "count",
                                      "min",
                                      "max",
                                      "median"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "stringLengthsUtf16": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "count": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "min": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "max": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "count",
                                      "min",
                                      "max"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "duplicateGroups": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "firstRowIndex": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "count": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "rowIndices": {
                                      "type": "array",
                                      "items": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "rowIndicesTruncated": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "firstRowIndex",
                                    "count",
                                    "rowIndices",
                                    "rowIndicesTruncated"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "duplicateGroupCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "duplicateGroupsTruncated": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "path",
                              "presentCount",
                              "missingCount",
                              "nullCount",
                              "distinctCount",
                              "typeCounts",
                              "numeric",
                              "stringLengthsUtf16",
                              "duplicateGroups",
                              "duplicateGroupCount",
                              "duplicateGroupsTruncated"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "caveats": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "rowCount",
                        "fields",
                        "caveats"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "record-profile",
                  "version": "0.29.0",
                  "result": {
                    "profile": "record-observations-v1",
                    "rowCount": 3,
                    "fields": [
                      {
                        "path": "/price",
                        "presentCount": 2,
                        "missingCount": 1,
                        "nullCount": 1,
                        "distinctCount": 2,
                        "typeCounts": {
                          "null": 1,
                          "boolean": 0,
                          "number": 1,
                          "string": 0,
                          "array": 0,
                          "object": 0
                        },
                        "numeric": {
                          "count": 1,
                          "min": 12,
                          "max": 12,
                          "median": 12
                        },
                        "stringLengthsUtf16": null,
                        "duplicateGroups": [],
                        "duplicateGroupCount": 0,
                        "duplicateGroupsTruncated": false
                      },
                      {
                        "path": "/status",
                        "presentCount": 3,
                        "missingCount": 0,
                        "nullCount": 0,
                        "distinctCount": 2,
                        "typeCounts": {
                          "null": 0,
                          "boolean": 0,
                          "number": 0,
                          "string": 3,
                          "array": 0,
                          "object": 0
                        },
                        "numeric": null,
                        "stringLengthsUtf16": {
                          "count": 3,
                          "min": 3,
                          "max": 5
                        },
                        "duplicateGroups": [
                          {
                            "firstRowIndex": 0,
                            "count": 2,
                            "rowIndices": [
                              0,
                              1
                            ],
                            "rowIndicesTruncated": false
                          }
                        ],
                        "duplicateGroupCount": 1,
                        "duplicateGroupsTruncated": false
                      }
                    ],
                    "caveats": [
                      "Observations describe only supplied rows, not a schema guarantee or population estimate.",
                      "Distinct values use typed structural JSON equality with object keys sorted; missing is separate from null. Numbers are already-parsed IEEE-754 values."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "7a3a2676a5c8b31f529bfb018adf6ce45a687787779349029dcae02ef5215fe9",
                    "outputSha256": "8135f48756dbce1bac61c230404690ca325e61c434d49d3b36c95903d7c4342d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/record-constraints": {
      "post": {
        "operationId": "x402_record_constraints",
        "summary": "Declarative record constraints",
        "description": "Evaluate up to 40 bounded rules across 500 supplied records: presence, JSON type, inclusive numeric bounds, string/array length, typed allowed values and composite uniqueness. Returns per-rule counts and row-addressed violations. No expressions, regex or automatic repair.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/record-constraints.md"
        },
        "x-agent-discovery": {
          "intents": [
            "validate dataset quality rules and composite uniqueness",
            "find records violating required fields ranges enums lengths",
            "return machine-readable row violations for data quality gates"
          ],
          "whenToUse": [
            "validate dataset quality rules and composite uniqueness",
            "find records violating required fields ranges enums lengths",
            "return machine-readable row violations for data quality gates"
          ],
          "whenNotToUse": [
            "Arbitrary JSON Schema conformance",
            "Evaluate code SQL regex or repair data automatically"
          ],
          "capabilities": [
            "declarative data quality rules",
            "composite unique keys",
            "row-level violation evidence",
            "complete counts with bounded findings"
          ],
          "related": [
            "record-profile",
            "record-relations",
            "json-schema-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "records": 500,
            "rules": 40,
            "compositeFields": 5
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1record-constraints/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "rules": {
                    "minItems": 1,
                    "maxItems": 40,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "present"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 512,
                              "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                            },
                            "allowNull": {
                              "default": false,
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "path"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "type"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 512,
                              "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                            },
                            "type": {
                              "type": "string",
                              "enum": [
                                "string",
                                "number",
                                "integer",
                                "boolean",
                                "null",
                                "array",
                                "object"
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "path",
                            "type"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "number-range"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 512,
                              "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                            },
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "path"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "length"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 512,
                              "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                            },
                            "min": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "max": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "path"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "one-of"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 512,
                              "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                            },
                            "values": {
                              "minItems": 1,
                              "maxItems": 50,
                              "type": "array",
                              "items": {
                                "type": [
                                  "string",
                                  "number",
                                  "boolean",
                                  "null"
                                ]
                              }
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "path",
                            "values"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "unique"
                            },
                            "paths": {
                              "minItems": 1,
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "maxLength": 512,
                                "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                              }
                            },
                            "missing": {
                              "default": "reject",
                              "type": "string",
                              "enum": [
                                "reject",
                                "ignore"
                              ]
                            },
                            "nulls": {
                              "default": "value",
                              "type": "string",
                              "enum": [
                                "value",
                                "ignore"
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "paths"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "records",
                  "rules"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1record-constraints/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1record-constraints/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "id": "a",
                    "score": 0.8
                  },
                  {
                    "id": "a",
                    "score": 1.2
                  },
                  {
                    "score": null
                  }
                ],
                "rules": [
                  {
                    "id": "id-required",
                    "kind": "present",
                    "path": "/id"
                  },
                  {
                    "id": "score-range",
                    "kind": "number-range",
                    "path": "/score",
                    "min": 0,
                    "max": 1
                  },
                  {
                    "id": "id-unique",
                    "kind": "unique",
                    "paths": [
                      "/id"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "record-constraints",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "record-constraints-v1"
                        },
                        "passes": {
                          "type": "boolean"
                        },
                        "rowCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "violationCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "rules": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "evaluatedCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "ignoredCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "violationCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "id",
                              "evaluatedCount",
                              "ignoredCount",
                              "violationCount"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "violations": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "rowIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "ruleId": {
                                "type": "string"
                              },
                              "relatedRowIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "code",
                              "rowIndex",
                              "path",
                              "message",
                              "ruleId",
                              "relatedRowIndex"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "caveats": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "passes",
                        "rowCount",
                        "violationCount",
                        "rules",
                        "violations",
                        "truncated",
                        "caveats"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "record-constraints",
                  "version": "0.29.0",
                  "result": {
                    "profile": "record-constraints-v1",
                    "passes": false,
                    "rowCount": 3,
                    "violationCount": 5,
                    "rules": [
                      {
                        "id": "id-required",
                        "evaluatedCount": 3,
                        "ignoredCount": 0,
                        "violationCount": 1
                      },
                      {
                        "id": "score-range",
                        "evaluatedCount": 3,
                        "ignoredCount": 0,
                        "violationCount": 2
                      },
                      {
                        "id": "id-unique",
                        "evaluatedCount": 3,
                        "ignoredCount": 0,
                        "violationCount": 2
                      }
                    ],
                    "violations": [
                      {
                        "code": "MISSING_VALUE",
                        "rowIndex": 2,
                        "path": "/id",
                        "message": "Field is absent",
                        "ruleId": "id-required",
                        "relatedRowIndex": null
                      },
                      {
                        "code": "OUT_OF_RANGE",
                        "rowIndex": 1,
                        "path": "/score",
                        "message": "Number is outside inclusive bounds",
                        "ruleId": "score-range",
                        "relatedRowIndex": null
                      },
                      {
                        "code": "TYPE_MISMATCH",
                        "rowIndex": 2,
                        "path": "/score",
                        "message": "Expected number; observed null",
                        "ruleId": "score-range",
                        "relatedRowIndex": null
                      },
                      {
                        "code": "DUPLICATE_VALUE",
                        "rowIndex": 1,
                        "path": "",
                        "message": "Composite key duplicates an earlier row",
                        "ruleId": "id-unique",
                        "relatedRowIndex": 0
                      },
                      {
                        "code": "MISSING_VALUE",
                        "rowIndex": 2,
                        "path": "",
                        "message": "A unique-key field is absent",
                        "ruleId": "id-unique",
                        "relatedRowIndex": null
                      }
                    ],
                    "truncated": false,
                    "caveats": [
                      "All rules are evaluated independently. Counts include findings beyond the retained evidence limit.",
                      "Unique violations identify each later duplicate and its first row; missing and null policies are explicit. String length uses UTF-16 code units."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "39ce3bc4f0e0760179cdc3f84efcab5402ccceee5fb13137750a1cf60d26e1b2",
                    "outputSha256": "d09e9b55481c864dbd6d0d45e910854e079e33edb7ea1599b9db64ab31ac8370",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/record-relations": {
      "post": {
        "operationId": "x402_record_relations",
        "summary": "Record referential integrity",
        "description": "Check typed scalar composite foreign keys between supplied parent and child records. Reports orphan, invalid and ambiguous child links, duplicate parent keys, optional null-child skipping and unreferenced parent rows. No database connection, coercion or guessed matches.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/record-relations.md"
        },
        "x-agent-discovery": {
          "intents": [
            "validate foreign keys between supplied JSON tables",
            "find orphan child records and ambiguous duplicate parent keys",
            "check composite referential integrity without a database"
          ],
          "whenToUse": [
            "validate foreign keys between supplied JSON tables",
            "find orphan child records and ambiguous duplicate parent keys",
            "check composite referential integrity without a database"
          ],
          "whenNotToUse": [
            "Query or mutate a live database",
            "Fuzzy entity resolution or automatic record joins"
          ],
          "capabilities": [
            "typed scalar composite keys",
            "orphan and ambiguity evidence",
            "null child policy",
            "unreferenced parent inventory"
          ],
          "related": [
            "record-constraints",
            "record-profile"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "parents": 500,
            "children": 500,
            "compositeFields": 5,
            "retainedParentMatchesPerChild": 10
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "parents": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1record-relations/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "children": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1record-relations/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "parentKey": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 512,
                      "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                    }
                  },
                  "childKey": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 512,
                      "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                    }
                  },
                  "skipNullChildKeys": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "parents",
                  "children",
                  "parentKey",
                  "childKey"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1record-relations/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1record-relations/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "parents": [
                  {
                    "org": "north",
                    "id": "1"
                  },
                  {
                    "org": "south",
                    "id": "1"
                  }
                ],
                "children": [
                  {
                    "org": "north",
                    "owner": "1"
                  },
                  {
                    "org": "north",
                    "owner": "2"
                  }
                ],
                "parentKey": [
                  "/org",
                  "/id"
                ],
                "childKey": [
                  "/org",
                  "/owner"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "record-relations",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "record-relations-v1"
                        },
                        "passes": {
                          "type": "boolean"
                        },
                        "parentCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "childCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matchedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "orphanCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "ambiguousCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "invalidChildCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "skippedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "invalidParentCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "duplicateParentKeyCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "links": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "childRowIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "matched",
                                  "orphan",
                                  "ambiguous",
                                  "invalid",
                                  "skipped"
                                ]
                              },
                              "code": {
                                "type": "string"
                              },
                              "parentRowIndices": {
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "parentMatchCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "parentRowIndicesTruncated": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "childRowIndex",
                              "status",
                              "code",
                              "parentRowIndices",
                              "parentMatchCount",
                              "parentRowIndicesTruncated"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "parentFindings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "rowIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "rowIndex",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "parentFindingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "parentFindingsTruncated": {
                          "type": "boolean"
                        },
                        "unreferencedValidParentRowIndices": {
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          }
                        },
                        "caveats": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "passes",
                        "parentCount",
                        "childCount",
                        "matchedCount",
                        "orphanCount",
                        "ambiguousCount",
                        "invalidChildCount",
                        "skippedCount",
                        "invalidParentCount",
                        "duplicateParentKeyCount",
                        "links",
                        "parentFindings",
                        "parentFindingCount",
                        "parentFindingsTruncated",
                        "unreferencedValidParentRowIndices",
                        "caveats"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "record-relations",
                  "version": "0.29.0",
                  "result": {
                    "profile": "record-relations-v1",
                    "passes": false,
                    "parentCount": 2,
                    "childCount": 2,
                    "matchedCount": 1,
                    "orphanCount": 1,
                    "ambiguousCount": 0,
                    "invalidChildCount": 0,
                    "skippedCount": 0,
                    "invalidParentCount": 0,
                    "duplicateParentKeyCount": 0,
                    "links": [
                      {
                        "childRowIndex": 0,
                        "status": "matched",
                        "code": "MATCHED",
                        "parentRowIndices": [
                          0
                        ],
                        "parentMatchCount": 1,
                        "parentRowIndicesTruncated": false
                      },
                      {
                        "childRowIndex": 1,
                        "status": "orphan",
                        "code": "MISSING_PARENT",
                        "parentRowIndices": [],
                        "parentMatchCount": 0,
                        "parentRowIndicesTruncated": false
                      }
                    ],
                    "parentFindings": [],
                    "parentFindingCount": 0,
                    "parentFindingsTruncated": false,
                    "unreferencedValidParentRowIndices": [
                      1
                    ],
                    "caveats": [
                      "Keys are typed scalar tuples; strings and numbers do not coerce. Parent null/missing/compound values are invalid.",
                      "Optional null-child skipping applies when any key field is null and none is missing. Ambiguous parent groups are never resolved to one row; unreferenced excludes every key matched by a child."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "8fc788220443d087baf6612349f0c395ee9ad57881ce107eb27503fabc482719",
                    "outputSha256": "bc441d2b05b7334c8dd22b5714bf451db766fb87868b2fd8e62f2e5c495d30ea",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/classification-evaluate": {
      "post": {
        "operationId": "x402_classification_evaluate",
        "summary": "Classification evaluation evidence",
        "description": "Evaluate up to 1,000 caller-supplied single-label expected/predicted pairs: confusion matrix, per-label precision/recall/F1/support, macro/weighted/micro summaries, balanced accuracy and mismatch evidence. Undefined per-label values use zero with explicit flags; labels are not verified ground truth.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/classification-evaluate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "calculate confusion matrix precision recall f1 from evaluation labels",
            "score agent routing classification predictions against supplied labels",
            "inspect macro micro weighted metrics and error samples"
          ],
          "whenToUse": [
            "calculate confusion matrix precision recall f1 from evaluation labels",
            "score agent routing classification predictions against supplied labels",
            "inspect macro micro weighted metrics and error samples"
          ],
          "whenNotToUse": [
            "Train or execute a model or infer factual ground truth",
            "Multilabel classification probability calibration or deployment certification"
          ],
          "capabilities": [
            "single-label classification metrics",
            "confusion matrix evidence",
            "undefined metric flags",
            "bounded mismatch samples"
          ],
          "related": [
            "ranking-evaluate",
            "span-evaluate"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "samples": 1000,
            "labels": 50
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "samples": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "expected": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "predicted": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "id",
                        "expected",
                        "predicted"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "labels": {
                    "default": [],
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    }
                  }
                },
                "required": [
                  "samples"
                ],
                "additionalProperties": false
              },
              "example": {
                "samples": [
                  {
                    "id": "e1",
                    "expected": "answer",
                    "predicted": "answer"
                  },
                  {
                    "id": "e2",
                    "expected": "abstain",
                    "predicted": "answer"
                  },
                  {
                    "id": "e3",
                    "expected": "abstain",
                    "predicted": "abstain"
                  }
                ],
                "labels": [
                  "answer",
                  "abstain"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "classification-evaluate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "single-label-evaluation-v1"
                        },
                        "sampleCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "labels": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "confusionMatrix": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          }
                        },
                        "perLabel": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "precision": {
                                "type": "number"
                              },
                              "recall": {
                                "type": "number"
                              },
                              "f1": {
                                "type": "number"
                              },
                              "label": {
                                "type": "string"
                              },
                              "truePositive": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "falsePositive": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "falseNegative": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "support": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "predictedCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "precisionDefined": {
                                "type": "boolean"
                              },
                              "recallDefined": {
                                "type": "boolean"
                              },
                              "f1Defined": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "precision",
                              "recall",
                              "f1",
                              "label",
                              "truePositive",
                              "falsePositive",
                              "falseNegative",
                              "support",
                              "predictedCount",
                              "precisionDefined",
                              "recallDefined",
                              "f1Defined"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "accuracy": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "balancedAccuracy": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "macro": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "precision": {
                                  "type": "number"
                                },
                                "recall": {
                                  "type": "number"
                                },
                                "f1": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "precision",
                                "recall",
                                "f1"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "weighted": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "precision": {
                                  "type": "number"
                                },
                                "recall": {
                                  "type": "number"
                                },
                                "f1": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "precision",
                                "recall",
                                "f1"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "micro": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "precision": {
                                  "type": "number"
                                },
                                "recall": {
                                  "type": "number"
                                },
                                "f1": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "precision",
                                "recall",
                                "f1"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "mismatchCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "mismatches": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "expected": {
                                "type": "string"
                              },
                              "predicted": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "expected",
                              "predicted"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "mismatchesTruncated": {
                          "type": "boolean"
                        },
                        "conventions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "sampleCount",
                        "labels",
                        "confusionMatrix",
                        "perLabel",
                        "accuracy",
                        "balancedAccuracy",
                        "macro",
                        "weighted",
                        "micro",
                        "mismatchCount",
                        "mismatches",
                        "mismatchesTruncated",
                        "conventions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "classification-evaluate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "single-label-evaluation-v1",
                    "sampleCount": 3,
                    "labels": [
                      "abstain",
                      "answer"
                    ],
                    "confusionMatrix": [
                      [
                        1,
                        1
                      ],
                      [
                        0,
                        1
                      ]
                    ],
                    "perLabel": [
                      {
                        "precision": 1,
                        "recall": 0.5,
                        "f1": 0.6666666666666666,
                        "label": "abstain",
                        "truePositive": 1,
                        "falsePositive": 0,
                        "falseNegative": 1,
                        "support": 2,
                        "predictedCount": 1,
                        "precisionDefined": true,
                        "recallDefined": true,
                        "f1Defined": true
                      },
                      {
                        "precision": 0.5,
                        "recall": 1,
                        "f1": 0.6666666666666666,
                        "label": "answer",
                        "truePositive": 1,
                        "falsePositive": 1,
                        "falseNegative": 0,
                        "support": 1,
                        "predictedCount": 2,
                        "precisionDefined": true,
                        "recallDefined": true,
                        "f1Defined": true
                      }
                    ],
                    "accuracy": 0.6666666666666666,
                    "balancedAccuracy": 0.75,
                    "macro": {
                      "precision": 0.75,
                      "recall": 0.75,
                      "f1": 0.6666666666666666
                    },
                    "weighted": {
                      "precision": 0.8333333333333334,
                      "recall": 0.6666666666666666,
                      "f1": 0.6666666666666666
                    },
                    "micro": {
                      "precision": 0.6666666666666666,
                      "recall": 0.6666666666666666,
                      "f1": 0.6666666666666666
                    },
                    "mismatchCount": 1,
                    "mismatches": [
                      {
                        "id": "e2",
                        "expected": "abstain",
                        "predicted": "answer"
                      }
                    ],
                    "mismatchesTruncated": false,
                    "conventions": [
                      "Confusion matrix rows are expected labels and columns are predicted labels; labels use code-unit lexical order.",
                      "Undefined per-label precision, recall or F1 is 0 with explicit defined flags. Macro includes all declared and observed labels; weighted uses expected support; balanced accuracy includes only supported labels.",
                      "Supplied expectations are not verified. No training, probability calibration, multilabel matching or inference about deployment quality."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "94e0ebdf6418835b5e24379c85e0dcf742165925f5cc787097b124279db65c32",
                    "outputSha256": "96304c42a7fa68f16782023dec0075af56722a1a75d391c578fcedb286492dc3",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/ranking-evaluate": {
      "post": {
        "operationId": "x402_ranking_evaluate",
        "summary": "Supplied ranking evaluation",
        "description": "Score ranked document IDs against caller-supplied graded judgments for up to 50 queries: precision/recall, reciprocal rank, truncated average precision and NDCG at k. Explicit gain, unjudged and zero-denominator conventions; evidence lists ranked judgments and missed relevant IDs. No search or relevance inference.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/ranking-evaluate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "evaluate retrieval ranking ndcg map mrr precision recall at k",
            "score search results against supplied relevance judgments",
            "compare RAG retrieval quality using judged document ids"
          ],
          "whenToUse": [
            "evaluate retrieval ranking ndcg map mrr precision recall at k",
            "score search results against supplied relevance judgments",
            "compare RAG retrieval quality using judged document ids"
          ],
          "whenNotToUse": [
            "Search the web or determine semantic document relevance",
            "Claim benchmark completeness from partial judgments"
          ],
          "capabilities": [
            "graded ranking metrics",
            "explicit unjudged handling",
            "linear or exponential gain",
            "query-level metric evidence"
          ],
          "related": [
            "classification-evaluate",
            "span-evaluate"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "queries": 50,
            "retrievedPerQuery": 100,
            "judgmentsPerQuery": 100,
            "maximumK": 100
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "queries": {
                    "minItems": 1,
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "retrieved": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 80
                          }
                        },
                        "judgments": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "grade": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 10
                              }
                            },
                            "required": [
                              "id",
                              "grade"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "retrieved",
                        "judgments"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "k": {
                    "default": 10,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "relevantAtLeast": {
                    "default": 1,
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 10
                  },
                  "gain": {
                    "default": "linear",
                    "type": "string",
                    "enum": [
                      "linear",
                      "exponential"
                    ]
                  },
                  "unjudged": {
                    "default": "error",
                    "type": "string",
                    "enum": [
                      "error",
                      "nonrelevant"
                    ]
                  }
                },
                "required": [
                  "queries"
                ],
                "additionalProperties": false
              },
              "example": {
                "queries": [
                  {
                    "id": "q1",
                    "retrieved": [
                      "b",
                      "a",
                      "c"
                    ],
                    "judgments": [
                      {
                        "id": "a",
                        "grade": 3
                      },
                      {
                        "id": "b",
                        "grade": 1
                      },
                      {
                        "id": "c",
                        "grade": 0
                      },
                      {
                        "id": "d",
                        "grade": 2
                      }
                    ]
                  }
                ],
                "k": 3
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "ranking-evaluate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "supplied-ranking-evaluation-v1"
                        },
                        "k": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "queryCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "queries": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "precisionAtK": {
                                "type": "number"
                              },
                              "recallAtK": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "reciprocalRankAtK": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "averagePrecisionAtK": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "ndcgAtK": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "id": {
                                "type": "string"
                              },
                              "relevantJudgmentCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "retrievedAtKCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "hitsAtK": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "unjudgedAtKCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "dcgAtK": {
                                "type": "number"
                              },
                              "idealDcgAtK": {
                                "type": "number"
                              },
                              "missedRelevantIds": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "ranking": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "rank": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "id": {
                                      "type": "string"
                                    },
                                    "grade": {
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    },
                                    "relevant": {
                                      "type": "boolean"
                                    },
                                    "judged": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "rank",
                                    "id",
                                    "grade",
                                    "relevant",
                                    "judged"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "precisionAtK",
                              "recallAtK",
                              "reciprocalRankAtK",
                              "averagePrecisionAtK",
                              "ndcgAtK",
                              "id",
                              "relevantJudgmentCount",
                              "retrievedAtKCount",
                              "hitsAtK",
                              "unjudgedAtKCount",
                              "dcgAtK",
                              "idealDcgAtK",
                              "missedRelevantIds",
                              "ranking"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "macro": {
                          "type": "object",
                          "properties": {
                            "precisionAtK": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "recallAtK": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "reciprocalRankAtK": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "averagePrecisionAtK": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "ndcgAtK": {
                              "type": [
                                "number",
                                "null"
                              ]
                            }
                          },
                          "required": [
                            "precisionAtK",
                            "recallAtK",
                            "reciprocalRankAtK",
                            "averagePrecisionAtK",
                            "ndcgAtK"
                          ],
                          "additionalProperties": false
                        },
                        "definedQueryCounts": {
                          "type": "object",
                          "properties": {
                            "precisionAtK": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "recallAtK": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "reciprocalRankAtK": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "averagePrecisionAtK": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "ndcgAtK": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "precisionAtK",
                            "recallAtK",
                            "reciprocalRankAtK",
                            "averagePrecisionAtK",
                            "ndcgAtK"
                          ],
                          "additionalProperties": false
                        },
                        "conventions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "k",
                        "queryCount",
                        "queries",
                        "macro",
                        "definedQueryCounts",
                        "conventions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "ranking-evaluate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "supplied-ranking-evaluation-v1",
                    "k": 3,
                    "queryCount": 1,
                    "queries": [
                      {
                        "precisionAtK": 0.6666666666666666,
                        "recallAtK": 0.6666666666666666,
                        "reciprocalRankAtK": 1,
                        "averagePrecisionAtK": 0.6666666666666666,
                        "ndcgAtK": 0.6074915180456525,
                        "id": "q1",
                        "relevantJudgmentCount": 3,
                        "retrievedAtKCount": 3,
                        "hitsAtK": 2,
                        "unjudgedAtKCount": 0,
                        "dcgAtK": 2.8927892607143724,
                        "idealDcgAtK": 4.7618595071429155,
                        "missedRelevantIds": [
                          "d"
                        ],
                        "ranking": [
                          {
                            "rank": 1,
                            "id": "b",
                            "grade": 1,
                            "relevant": true,
                            "judged": true
                          },
                          {
                            "rank": 2,
                            "id": "a",
                            "grade": 3,
                            "relevant": true,
                            "judged": true
                          },
                          {
                            "rank": 3,
                            "id": "c",
                            "grade": 0,
                            "relevant": false,
                            "judged": true
                          }
                        ]
                      }
                    ],
                    "macro": {
                      "precisionAtK": 0.6666666666666666,
                      "recallAtK": 0.6666666666666666,
                      "reciprocalRankAtK": 1,
                      "averagePrecisionAtK": 0.6666666666666666,
                      "ndcgAtK": 0.6074915180456525
                    },
                    "definedQueryCounts": {
                      "precisionAtK": 1,
                      "recallAtK": 1,
                      "reciprocalRankAtK": 1,
                      "averagePrecisionAtK": 1,
                      "ndcgAtK": 1
                    },
                    "conventions": [
                      "Precision denominator is k even when fewer results are supplied. Recall and truncated AP denominators use all supplied relevant judgments; reciprocal rank is truncated at k.",
                      "DCG uses linear gain and log2(rank + 1) discount. Ideal DCG uses all supplied judgments sorted by grade, truncated at k.",
                      "No-relevant-judgment recall, reciprocal rank and AP are null; zero-ideal-gain NDCG is null. Macro averages exclude nulls and report denominators.",
                      "Evaluation uses supplied judgments only. It does not retrieve documents, judge semantic relevance, or establish complete relevance coverage."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "a830c056a36bdf25d24ce65b0f72f06975f4ac98f7a9cb4aa70c79f3c3fd8b4f",
                    "outputSha256": "948595d1d37750d1e18558475116ee9dd440ddde396ae7edc49b7d9f909ac4d0",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/span-evaluate": {
      "post": {
        "operationId": "x402_span_evaluate",
        "summary": "Annotation span evaluation",
        "description": "Evaluate supplied labeled text spans with exact boundaries or thresholded intersection-over-union. Bounded deterministic maximum-cardinality one-to-one matching returns precision/recall/F1, matches and unmatched IDs. UTF-16 half-open offsets are validated; labels and text meaning are not judged.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/span-evaluate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "evaluate named entity extraction annotation spans",
            "match predicted and reference text spans using exact offsets or iou",
            "calculate one-to-one span precision recall and unmatched evidence"
          ],
          "whenToUse": [
            "evaluate named entity extraction annotation spans",
            "match predicted and reference text spans using exact offsets or iou",
            "calculate one-to-one span precision recall and unmatched evidence"
          ],
          "whenNotToUse": [
            "Semantic factuality or entailment checking",
            "Tokenization byte offsets or globally maximum total IoU matching"
          ],
          "capabilities": [
            "exact or overlap span evaluation",
            "maximum-cardinality matching",
            "surrogate-safe UTF-16 boundaries",
            "per-label metrics and unmatched evidence"
          ],
          "related": [
            "classification-evaluate",
            "evidence-quote-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "textUtf16Units": 50000,
            "references": 100,
            "predictions": 100
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "references": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "label": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "id",
                        "label",
                        "start",
                        "end"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "predictions": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "label": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "id",
                        "label",
                        "start",
                        "end"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "match": {
                    "default": "exact",
                    "type": "string",
                    "enum": [
                      "exact",
                      "overlap"
                    ]
                  },
                  "minimumIou": {
                    "default": 0.5,
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 1
                  }
                },
                "required": [
                  "text",
                  "references",
                  "predictions"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Ada builds agents in London.",
                "references": [
                  {
                    "id": "r1",
                    "label": "person",
                    "start": 0,
                    "end": 3
                  },
                  {
                    "id": "r2",
                    "label": "place",
                    "start": 21,
                    "end": 27
                  }
                ],
                "predictions": [
                  {
                    "id": "p1",
                    "label": "person",
                    "start": 0,
                    "end": 3
                  },
                  {
                    "id": "p2",
                    "label": "place",
                    "start": 21,
                    "end": 26
                  }
                ],
                "match": "overlap",
                "minimumIou": 0.8
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "span-evaluate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "annotation-span-evaluation-v1"
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "utf16-code-unit"
                        },
                        "referenceCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "predictionCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matchedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "precision": {
                          "type": "number"
                        },
                        "recall": {
                          "type": "number"
                        },
                        "f1": {
                          "type": "number"
                        },
                        "precisionDefined": {
                          "type": "boolean"
                        },
                        "recallDefined": {
                          "type": "boolean"
                        },
                        "meanMatchedIou": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "matches": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "predictionId": {
                                "type": "string"
                              },
                              "referenceId": {
                                "type": "string"
                              },
                              "label": {
                                "type": "string"
                              },
                              "iou": {
                                "type": "number"
                              },
                              "exactBoundaries": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "predictionId",
                              "referenceId",
                              "label",
                              "iou",
                              "exactBoundaries"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "unmatchedPredictionIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "unmatchedReferenceIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "perLabel": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "label": {
                                "type": "string"
                              },
                              "referenceCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "predictionCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "matchedCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "precision": {
                                "type": "number"
                              },
                              "recall": {
                                "type": "number"
                              },
                              "f1": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "label",
                              "referenceCount",
                              "predictionCount",
                              "matchedCount",
                              "precision",
                              "recall",
                              "f1"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "conventions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "offsetUnit",
                        "referenceCount",
                        "predictionCount",
                        "matchedCount",
                        "precision",
                        "recall",
                        "f1",
                        "precisionDefined",
                        "recallDefined",
                        "meanMatchedIou",
                        "matches",
                        "unmatchedPredictionIds",
                        "unmatchedReferenceIds",
                        "perLabel",
                        "conventions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "span-evaluate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "annotation-span-evaluation-v1",
                    "offsetUnit": "utf16-code-unit",
                    "referenceCount": 2,
                    "predictionCount": 2,
                    "matchedCount": 2,
                    "precision": 1,
                    "recall": 1,
                    "f1": 1,
                    "precisionDefined": true,
                    "recallDefined": true,
                    "meanMatchedIou": 0.9166666666666667,
                    "matches": [
                      {
                        "predictionId": "p1",
                        "referenceId": "r1",
                        "label": "person",
                        "iou": 1,
                        "exactBoundaries": true
                      },
                      {
                        "predictionId": "p2",
                        "referenceId": "r2",
                        "label": "place",
                        "iou": 0.8333333333333334,
                        "exactBoundaries": false
                      }
                    ],
                    "unmatchedPredictionIds": [],
                    "unmatchedReferenceIds": [],
                    "perLabel": [
                      {
                        "label": "person",
                        "referenceCount": 1,
                        "predictionCount": 1,
                        "matchedCount": 1,
                        "precision": 1,
                        "recall": 1,
                        "f1": 1
                      },
                      {
                        "label": "place",
                        "referenceCount": 1,
                        "predictionCount": 1,
                        "matchedCount": 1,
                        "precision": 1,
                        "recall": 1,
                        "f1": 1
                      }
                    ],
                    "conventions": [
                      "Spans are nonempty half-open UTF-16 code-unit ranges; surrogate pairs cannot be split. Labels match exactly. Repeated label/boundary spans on the same side are rejected.",
                      "Matching maximizes one-to-one pair count. Deterministic ID order and local IoU preference break ties; total IoU is not globally maximized.",
                      "Undefined precision/recall/F1 uses 0. This evaluates supplied annotations and boundaries, not the truth or meaning of their labels."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "17fd96b5568ac2fb16fcbdb52e9741bfa919234807e289f37c7ea47b30710f28",
                    "outputSha256": "69f28072bd7f33501f9d2566743476fd9024f8437868687e435fa8156ff5c4f1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/time-series-inspect": {
      "post": {
        "operationId": "x402_time_series_inspect",
        "summary": "Time-series cadence inspection",
        "description": "Inspect up to 1,000 supplied timestamp/value points for ordering, duplicate timestamps, null values and optional cadence deviations. Returns bounded interval evidence, aligned missing-point estimates and descriptive numeric summaries. No clock, interpolation, anomaly prediction or forecasting.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/time-series-inspect.md"
        },
        "x-agent-discovery": {
          "intents": [
            "inspect time series cadence gaps duplicate timestamps and null readings",
            "validate chronological telemetry points before analysis",
            "find irregular intervals and missing observations in supplied data"
          ],
          "whenToUse": [
            "inspect time series cadence gaps duplicate timestamps and null readings",
            "validate chronological telemetry points before analysis",
            "find irregular intervals and missing observations in supplied data"
          ],
          "whenNotToUse": [
            "Forecast prices predict anomalies or make trading decisions",
            "Fetch live telemetry or infer wall-clock freshness"
          ],
          "capabilities": [
            "chronological ordering evidence",
            "duplicate timestamp groups",
            "cadence deviation evidence",
            "bounded descriptive summaries"
          ],
          "related": [
            "interval-analyze",
            "timestamp-convert"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "points": 1000,
            "timestampUnit": "Unix milliseconds",
            "numericAbsoluteMaximum": 1e+100
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "points": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "timeMs": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 8640000000000000
                        },
                        "value": {
                          "anyOf": [
                            {
                              "type": "number",
                              "minimum": -1e+100,
                              "maximum": 1e+100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "timeMs",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "expectedStepMs": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 8640000000000000
                  },
                  "toleranceMs": {
                    "default": 0,
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 8640000000000000
                  }
                },
                "required": [
                  "points"
                ],
                "additionalProperties": false
              },
              "example": {
                "points": [
                  {
                    "timeMs": 0,
                    "value": 10
                  },
                  {
                    "timeMs": 1000,
                    "value": 12
                  },
                  {
                    "timeMs": 3000,
                    "value": null
                  },
                  {
                    "timeMs": 1000,
                    "value": 11
                  }
                ],
                "expectedStepMs": 1000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "time-series-inspect",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "time-series-inspection-v1"
                        },
                        "pointCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "distinctTimestampCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "nullValueCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "firstTimeMs": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 8640000000000000
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "lastTimeMs": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 8640000000000000
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "sortedInput": {
                          "type": "boolean"
                        },
                        "outOfOrderPairCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "outOfOrderPairs": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "previousRowIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "rowIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "previousTimeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8640000000000000
                              },
                              "timeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8640000000000000
                              }
                            },
                            "required": [
                              "previousRowIndex",
                              "rowIndex",
                              "previousTimeMs",
                              "timeMs"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "outOfOrderPairsTruncated": {
                          "type": "boolean"
                        },
                        "duplicateTimestampCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "duplicateTimestamps": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "timeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8640000000000000
                              },
                              "count": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "rowIndices": {
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "rowIndicesTruncated": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "timeMs",
                              "count",
                              "rowIndices",
                              "rowIndicesTruncated"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "duplicateTimestampsTruncated": {
                          "type": "boolean"
                        },
                        "cadenceChecked": {
                          "type": "boolean"
                        },
                        "irregularIntervalCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "irregularIntervals": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "fromTimeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8640000000000000
                              },
                              "toTimeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8640000000000000
                              },
                              "deltaMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "short",
                                  "long"
                                ]
                              },
                              "inferredMissingPoints": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "fromTimeMs",
                              "toTimeMs",
                              "deltaMs",
                              "kind",
                              "inferredMissingPoints"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "irregularIntervalsTruncated": {
                          "type": "boolean"
                        },
                        "numeric": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "count": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "min": {
                                  "type": "number"
                                },
                                "max": {
                                  "type": "number"
                                },
                                "mean": {
                                  "type": "number"
                                },
                                "median": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "count",
                                "min",
                                "max",
                                "mean",
                                "median"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "conventions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "pointCount",
                        "distinctTimestampCount",
                        "nullValueCount",
                        "firstTimeMs",
                        "lastTimeMs",
                        "sortedInput",
                        "outOfOrderPairCount",
                        "outOfOrderPairs",
                        "outOfOrderPairsTruncated",
                        "duplicateTimestampCount",
                        "duplicateTimestamps",
                        "duplicateTimestampsTruncated",
                        "cadenceChecked",
                        "irregularIntervalCount",
                        "irregularIntervals",
                        "irregularIntervalsTruncated",
                        "numeric",
                        "conventions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "time-series-inspect",
                  "version": "0.29.0",
                  "result": {
                    "profile": "time-series-inspection-v1",
                    "pointCount": 4,
                    "distinctTimestampCount": 3,
                    "nullValueCount": 1,
                    "firstTimeMs": 0,
                    "lastTimeMs": 3000,
                    "sortedInput": false,
                    "outOfOrderPairCount": 1,
                    "outOfOrderPairs": [
                      {
                        "previousRowIndex": 2,
                        "rowIndex": 3,
                        "previousTimeMs": 3000,
                        "timeMs": 1000
                      }
                    ],
                    "outOfOrderPairsTruncated": false,
                    "duplicateTimestampCount": 1,
                    "duplicateTimestamps": [
                      {
                        "timeMs": 1000,
                        "count": 2,
                        "rowIndices": [
                          1,
                          3
                        ],
                        "rowIndicesTruncated": false
                      }
                    ],
                    "duplicateTimestampsTruncated": false,
                    "cadenceChecked": true,
                    "irregularIntervalCount": 1,
                    "irregularIntervals": [
                      {
                        "fromTimeMs": 1000,
                        "toTimeMs": 3000,
                        "deltaMs": 2000,
                        "kind": "long",
                        "inferredMissingPoints": 1
                      }
                    ],
                    "irregularIntervalsTruncated": false,
                    "numeric": {
                      "count": 3,
                      "min": 10,
                      "max": 12,
                      "mean": 11,
                      "median": 11
                    },
                    "conventions": [
                      "Timestamps are supplied Unix milliseconds. Cadence checks adjacent distinct sorted timestamps, not absolute grid phase or wall-clock freshness.",
                      "Missing-point counts are inferred only when a long interval is within tolerance of an integer step multiple. Other irregular intervals return null; no data is imputed.",
                      "Numeric summary includes every non-null supplied value, including duplicate timestamps. Statistics use IEEE-754 arithmetic and do not establish a forecast or anomaly cause."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "9e9f6fa86c25c41d24fc6a75e6b1ecb1eac14ad7773de1b2ed73918897510926",
                    "outputSha256": "7aa0ada91ec76f7c1cbe2f504d5a66b00d27da27f68aae4e128228d1a1ff0b99",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/interval-analyze": {
      "post": {
        "operationId": "x402_interval_analyze",
        "summary": "Interval coverage and overlaps",
        "description": "Analyze up to 300 integer half-open intervals inside an explicit window: clipped union, gaps, covered/multiply-covered duration, concurrency segments and overlap-pair evidence. Touching endpoints do not overlap. No calendar access, reservations or scheduling actions.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/interval-analyze.md"
        },
        "x-agent-discovery": {
          "intents": [
            "calculate interval coverage union gaps overlaps and concurrency",
            "inspect execution windows for overlaps and uncovered time",
            "find coverage gaps in supplied numeric ranges"
          ],
          "whenToUse": [
            "calculate interval coverage union gaps overlaps and concurrency",
            "inspect execution windows for overlaps and uncovered time",
            "find coverage gaps in supplied numeric ranges"
          ],
          "whenNotToUse": [
            "Book meetings mutate calendars or schedule execution",
            "Interpret timezone recurrences or continuous noninteger geometry"
          ],
          "capabilities": [
            "half-open interval union",
            "window clipping and gap analysis",
            "maximum concurrency",
            "complete overlap counts with bounded evidence"
          ],
          "related": [
            "time-series-inspect",
            "workflow-dag-analyze"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "intervals": 300,
            "endpointAbsoluteMaximum": 1000000000000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "window": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "integer",
                        "minimum": -1000000000000,
                        "maximum": 1000000000000
                      },
                      "end": {
                        "type": "integer",
                        "minimum": -1000000000000,
                        "maximum": 1000000000000
                      }
                    },
                    "required": [
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  },
                  "intervals": {
                    "maxItems": 300,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "start": {
                          "type": "integer",
                          "minimum": -1000000000000,
                          "maximum": 1000000000000
                        },
                        "end": {
                          "type": "integer",
                          "minimum": -1000000000000,
                          "maximum": 1000000000000
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "start",
                        "end",
                        "id"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "unit": {
                    "default": "units",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 40
                  }
                },
                "required": [
                  "window",
                  "intervals"
                ],
                "additionalProperties": false
              },
              "example": {
                "window": {
                  "start": 0,
                  "end": 20
                },
                "intervals": [
                  {
                    "id": "a",
                    "start": 2,
                    "end": 8
                  },
                  {
                    "id": "b",
                    "start": 6,
                    "end": 12
                  },
                  {
                    "id": "c",
                    "start": 15,
                    "end": 25
                  }
                ],
                "unit": "seconds"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "interval-analyze",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "half-open-intervals-v1"
                        },
                        "unit": {
                          "type": "string"
                        },
                        "window": {
                          "type": "object",
                          "properties": {
                            "start": {
                              "type": "integer",
                              "minimum": -1000000000000,
                              "maximum": 1000000000000
                            },
                            "end": {
                              "type": "integer",
                              "minimum": -1000000000000,
                              "maximum": 1000000000000
                            }
                          },
                          "required": [
                            "start",
                            "end"
                          ],
                          "additionalProperties": false
                        },
                        "intervalCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "consideredCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "outsideWindowIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "clippedIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "coveredDuration": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "uncoveredDuration": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "multiplyCoveredDuration": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "maximumConcurrency": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "coverage": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "activeCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "activeCount"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "union": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "gaps": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "overlappingPairCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "overlappingPairs": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "leftId": {
                                "type": "string"
                              },
                              "rightId": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "leftId",
                              "rightId"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "overlappingPairsTruncated": {
                          "type": "boolean"
                        },
                        "conventions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "unit",
                        "window",
                        "intervalCount",
                        "consideredCount",
                        "outsideWindowIds",
                        "clippedIds",
                        "coveredDuration",
                        "uncoveredDuration",
                        "multiplyCoveredDuration",
                        "maximumConcurrency",
                        "coverage",
                        "union",
                        "gaps",
                        "overlappingPairCount",
                        "overlappingPairs",
                        "overlappingPairsTruncated",
                        "conventions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "interval-analyze",
                  "version": "0.29.0",
                  "result": {
                    "profile": "half-open-intervals-v1",
                    "unit": "seconds",
                    "window": {
                      "start": 0,
                      "end": 20
                    },
                    "intervalCount": 3,
                    "consideredCount": 3,
                    "outsideWindowIds": [],
                    "clippedIds": [
                      "c"
                    ],
                    "coveredDuration": 15,
                    "uncoveredDuration": 5,
                    "multiplyCoveredDuration": 2,
                    "maximumConcurrency": 2,
                    "coverage": [
                      {
                        "start": 0,
                        "end": 2,
                        "activeCount": 0
                      },
                      {
                        "start": 2,
                        "end": 6,
                        "activeCount": 1
                      },
                      {
                        "start": 6,
                        "end": 8,
                        "activeCount": 2
                      },
                      {
                        "start": 8,
                        "end": 12,
                        "activeCount": 1
                      },
                      {
                        "start": 12,
                        "end": 15,
                        "activeCount": 0
                      },
                      {
                        "start": 15,
                        "end": 20,
                        "activeCount": 1
                      }
                    ],
                    "union": [
                      {
                        "start": 2,
                        "end": 12
                      },
                      {
                        "start": 15,
                        "end": 20
                      }
                    ],
                    "gaps": [
                      {
                        "start": 0,
                        "end": 2
                      },
                      {
                        "start": 12,
                        "end": 15
                      }
                    ],
                    "overlappingPairCount": 1,
                    "overlappingPairs": [
                      {
                        "start": 6,
                        "end": 8,
                        "leftId": "a",
                        "rightId": "b"
                      }
                    ],
                    "overlappingPairsTruncated": false,
                    "conventions": [
                      "All intervals are half-open [start,end); touching endpoints do not overlap. Results are clipped to the explicit window.",
                      "Coverage segments represent active counts, not interval identity. Pair counts include every overlap even when retained evidence is truncated. Units are caller-declared; no scheduling action is performed."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "14a28f54ff2cc9b8b24efc58e227f8ab3e1961948d1cac7ce9eb0d6c05d52f16",
                    "outputSha256": "294ba7cd239f7eba59845ab765a99c804049f5f7c1e97af230ca8a65b97e8568",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/openapi-response-check": {
      "post": {
        "operationId": "x402_openapi_response_check",
        "summary": "OpenAPI Response Contract Check",
        "description": "Check one supplied OpenAPI 3.1 inline response against status, explicit JSON media type, parsed JSON body and deserialized headers. Exact status precedes class and default; unsupported references and schemas are explicit. Not full OpenAPI validation, wire decoding, authentication or request execution.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/openapi-response-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate supplied API response body and response headers against OpenAPI",
            "Select exact status, response class or default before checking JSON output"
          ],
          "whenToUse": [
            "Validate supplied API response body and response headers against OpenAPI",
            "Select exact status, response class or default before checking JSON output"
          ],
          "whenNotToUse": [
            "Full OpenAPI conformance, reference resolution, parameter serialization, wire parsing or live API tests",
            "Proving absence of body is an error solely because content is documented"
          ],
          "capabilities": [
            "Exact status > class > default; exact media type > type wildcard > global wildcard",
            "Reuses the bounded safe-json-schema-subset-v1 evaluator",
            "Source: https://spec.openapis.org/oas/v3.1.1.html#responses-object"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "declaredHeaders": 40,
            "schemaEvaluationsPerValue": 50000
          },
          "related": [
            "openapi-request-check",
            "openapi-lint",
            "json-schema-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1x402~1openapi-response-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "path": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "get",
                      "put",
                      "post",
                      "delete",
                      "options",
                      "head",
                      "patch",
                      "trace"
                    ]
                  },
                  "statusCode": {
                    "type": "integer",
                    "minimum": 100,
                    "maximum": 599
                  },
                  "mediaType": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "headers": {
                    "default": {},
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "$ref": "#/paths/~1v1~1x402~1openapi-response-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                    }
                  },
                  "body": {
                    "$ref": "#/paths/~1v1~1x402~1openapi-response-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "document",
                  "path",
                  "method",
                  "statusCode"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-response-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1openapi-response-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "openapi": "3.1.1",
                  "info": {
                    "title": "Orders",
                    "version": "1"
                  },
                  "paths": {
                    "/orders/{id}": {
                      "get": {
                        "responses": {
                          "200": {
                            "description": "Order",
                            "headers": {
                              "X-Revision": {
                                "required": true,
                                "schema": {
                                  "type": "integer",
                                  "minimum": 1
                                }
                              }
                            },
                            "content": {
                              "application/json": {
                                "schema": {
                                  "type": "object",
                                  "required": [
                                    "id"
                                  ],
                                  "properties": {
                                    "id": {
                                      "type": "integer"
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "path": "/orders/{id}",
                "method": "get",
                "statusCode": 200,
                "mediaType": "application/json",
                "headers": {
                  "x-revision": 3
                },
                "body": {
                  "id": 7
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "openapi-response-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "openapi-inline-response-subset-v1"
                        },
                        "selectedResponse": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "selectedMediaType": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "checkedValues": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "supported": {
                          "type": "boolean"
                        },
                        "valid": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "findings": {
                          "maxItems": 150,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "selectedResponse",
                        "selectedMediaType",
                        "checkedValues",
                        "supported",
                        "valid",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "openapi-response-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "openapi-inline-response-subset-v1",
                    "selectedResponse": "200",
                    "selectedMediaType": "application/json",
                    "checkedValues": 2,
                    "supported": true,
                    "valid": true,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "371d889a55821f9bd2ab80f9f054e30a24df0c59ea8f13ef34a0a93f1b8f2561",
                    "outputSha256": "9e42eb8a67ea73a62a168a3bf735cafd6a7e6bbe981a239f6de157dff936290b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/mcp-result-check": {
      "post": {
        "operationId": "x402_mcp_result_check",
        "summary": "MCP Tool Result Check",
        "description": "Inspect a supplied MCP CallToolResult text/structured-content envelope and optional object-root output schema. Separates tool execution errors, missing structured output, invalid text blocks and unsupported content/schema features. Does not invoke tools or prove MCP interoperability, provenance, or trust.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/mcp-result-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate MCP tool result structuredContent against outputSchema",
            "Distinguish tool execution error from malformed tool result envelope"
          ],
          "whenToUse": [
            "Validate MCP tool result structuredContent against outputSchema",
            "Distinguish tool execution error from malformed tool result envelope"
          ],
          "whenNotToUse": [
            "MCP lifecycle, JSON-RPC correlation, binary/media/resources, annotation validation or security verdicts",
            "Full JSON Schema or trusting tool output because its shape passes"
          ],
          "capabilities": [
            "Text and structured-content subset with explicit unsupported coverage",
            "Source: https://modelcontextprotocol.io/specification/2025-11-25/server/tools"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "contentBlocks": 200,
            "schemaEvaluations": 50000
          },
          "related": [
            "mcp-tool-lint",
            "jsonrpc-exchange-check",
            "json-schema-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "result": {
                    "$ref": "#/paths/~1v1~1x402~1mcp-result-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "outputSchema": {
                    "$ref": "#/paths/~1v1~1x402~1mcp-result-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "result"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1mcp-result-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1mcp-result-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "result": {
                  "content": [
                    {
                      "type": "text",
                      "text": "{\"count\":2}"
                    }
                  ],
                  "structuredContent": {
                    "count": 2
                  }
                },
                "outputSchema": {
                  "type": "object",
                  "required": [
                    "count"
                  ],
                  "properties": {
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "mcp-result-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "mcp-text-structured-result-v1"
                        },
                        "isToolError": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "textBlocks": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "structuredContentPresent": {
                          "type": "boolean"
                        },
                        "outputSchemaChecked": {
                          "type": "boolean"
                        },
                        "supported": {
                          "type": "boolean"
                        },
                        "valid": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "findings": {
                          "maxItems": 150,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "isToolError",
                        "textBlocks",
                        "structuredContentPresent",
                        "outputSchemaChecked",
                        "supported",
                        "valid",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "mcp-result-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "mcp-text-structured-result-v1",
                    "isToolError": false,
                    "textBlocks": 1,
                    "structuredContentPresent": true,
                    "outputSchemaChecked": true,
                    "supported": true,
                    "valid": true,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "f15ab813dd2b040e164ae7fdbcc3969124d96c0cb262273ac1c3bd3e1424f75a",
                    "outputSha256": "a80d21f8ca776ae430678e746fc3900a820f242f8986c2f408d543b08f9e74eb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/sse-stream-parse": {
      "post": {
        "operationId": "x402_sse_stream_parse",
        "summary": "SSE Snapshot Event Parser",
        "description": "Parse a completed, already-decoded server-sent-event text snapshot into dispatched events, committed last-event ID, exact decimal retry milliseconds and ignored-field count. Handles CR/LF/CRLF, one leading BOM, blank dispatch and incomplete EOF discard. No live connection, resumption or provider-specific event semantics.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/sse-stream-parse.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Parse saved SSE event stream and inspect last event ID",
            "Diagnose missing events caused by incomplete final blank line"
          ],
          "whenToUse": [
            "Parse saved SSE event stream and inspect last event ID",
            "Diagnose missing events caused by incomplete final blank line"
          ],
          "whenNotToUse": [
            "Opening an SSE stream, joining arbitrary incremental chunks or retrying connections",
            "Raw-byte UTF-8 decoding, provider completion markers or JSON-RPC protocol validation"
          ],
          "capabilities": [
            "Committed ID is distinct from an EOF-only pending ID buffer",
            "Retry decimal string avoids unsafe integer rounding",
            "Source: https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "lines": 5000,
            "events": 500,
            "eventJsonBytes": 300000
          },
          "related": [
            "jsonrpc-exchange-check",
            "ndjson-inspect",
            "retry-schedule-plan"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "initialLastEventId": {
                    "default": "",
                    "type": "string",
                    "maxLength": 4096
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "id: 42\nevent: message\ndata: {\"delta\":\"hello\"}\n\nretry: 1500\n\ndata: unfinished"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "sse-stream-parse",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "sse-completed-text-snapshot-v1"
                        },
                        "events": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "event": {
                                "type": "string"
                              },
                              "data": {
                                "type": "string"
                              },
                              "lastEventId": {
                                "type": "string"
                              },
                              "dispatchLine": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "event",
                              "data",
                              "lastEventId",
                              "dispatchLine"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "lastEventId": {
                          "type": "string"
                        },
                        "retryMilliseconds": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "ignoredFields": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "discardedPendingData": {
                          "type": "boolean"
                        },
                        "processedLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "profile",
                        "events",
                        "lastEventId",
                        "retryMilliseconds",
                        "ignoredFields",
                        "discardedPendingData",
                        "processedLines"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "sse-stream-parse",
                  "version": "0.29.0",
                  "result": {
                    "profile": "sse-completed-text-snapshot-v1",
                    "events": [
                      {
                        "event": "message",
                        "data": "{\"delta\":\"hello\"}",
                        "lastEventId": "42",
                        "dispatchLine": 4
                      }
                    ],
                    "lastEventId": "42",
                    "retryMilliseconds": "1500",
                    "ignoredFields": 0,
                    "discardedPendingData": true,
                    "processedLines": 7
                  },
                  "provenance": {
                    "inputSha256": "58b368c800a1a315f171c3001987b017f2af3ded5cf8e3247f821a75460e3edb",
                    "outputSha256": "06104a669752ff07a7d9b7d29e3d2b3a46d918fa3e5d2075bafcfb7ef0d5550a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/ndjson-inspect": {
      "post": {
        "operationId": "x402_ndjson_inspect",
        "summary": "NDJSON Artifact Inspector",
        "description": "Inspect supplied newline-delimited JSON text into parsed records with line numbers and exact UTF-16 spans, bounded per-line diagnostics, explicit empty-line policy and optional final-newline requirement. Rejects bare CR, unsafe keys, nonfinite numbers and excessive structure; no lossless number or duplicate-key preservation.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/ndjson-inspect.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate JSON Lines or NDJSON batch artifacts with exact failing line numbers",
            "Parse newline JSON tool logs while keeping source offsets and malformed-line diagnostics"
          ],
          "whenToUse": [
            "Validate JSON Lines or NDJSON batch artifacts with exact failing line numbers",
            "Parse newline JSON tool logs while keeping source offsets and malformed-line diagnostics"
          ],
          "whenNotToUse": [
            "Streaming network ingestion, arbitrary log formats or multiline JSON documents",
            "Lossless large numbers, duplicate-key detection or implicit repair"
          ],
          "capabilities": [
            "LF and CRLF framing; strict NDJSON final newline enabled by default",
            "Source: https://github.com/ndjson/ndjson-spec"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "lines": 500,
            "aggregateParsedNodes": 12000
          },
          "related": [
            "json-schema-check",
            "record-profile",
            "sse-stream-parse"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "emptyLines": {
                    "default": "error",
                    "type": "string",
                    "enum": [
                      "ignore",
                      "error"
                    ]
                  },
                  "requireFinalNewline": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "{\"id\":\"a\",\"ok\":true}\r\n{\"id\":\"b\",\"ok\":false}\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "ndjson-inspect",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "ndjson-bounded-artifact-v1"
                        },
                        "valid": {
                          "type": "boolean"
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16-code-units"
                        },
                        "records": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "line": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "value": {
                                "$ref": "#/paths/~1v1~1x402~1ndjson-inspect/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            "required": [
                              "line",
                              "start",
                              "end",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "errors": {
                          "maxItems": 501,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "line": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "code": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "line",
                              "start",
                              "end",
                              "code"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "ignoredEmptyLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "finalNewline": {
                          "type": "boolean"
                        },
                        "numericPrecision": {
                          "type": "string",
                          "const": "IEEE-754; duplicate JSON object names use last value"
                        }
                      },
                      "required": [
                        "profile",
                        "valid",
                        "offsetUnit",
                        "records",
                        "errors",
                        "ignoredEmptyLines",
                        "finalNewline",
                        "numericPrecision"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1ndjson-inspect/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1ndjson-inspect/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "ndjson-inspect",
                  "version": "0.29.0",
                  "result": {
                    "profile": "ndjson-bounded-artifact-v1",
                    "valid": true,
                    "offsetUnit": "UTF-16-code-units",
                    "records": [
                      {
                        "line": 1,
                        "start": 0,
                        "end": 20,
                        "value": {
                          "id": "a",
                          "ok": true
                        }
                      },
                      {
                        "line": 2,
                        "start": 22,
                        "end": 43,
                        "value": {
                          "id": "b",
                          "ok": false
                        }
                      }
                    ],
                    "errors": [],
                    "ignoredEmptyLines": 0,
                    "finalNewline": true,
                    "numericPrecision": "IEEE-754; duplicate JSON object names use last value"
                  },
                  "provenance": {
                    "inputSha256": "d62d6909f6d24a5a208b7a2070773bdcc5fc3e42f895096bf9bd4714c905e79d",
                    "outputSha256": "9f2dc04e2f49dd9b31cfcc390eeaf23c85d4c70ea020fe20510e1ee4cd6e7506",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/uri-template-expand": {
      "post": {
        "operationId": "x402_uri_template_expand",
        "summary": "Scalar URI Template Expansion",
        "description": "Expand RFC6570 scalar string variables with simple, reserved, fragment, label, path, path-parameter and query operators. Explicitly rejects prefix/explode modifiers, lists/maps and non-ASCII variable names/literals. Missing/null variables are omitted with an audit list; no URL fetch, safety verdict or encoding guesswork.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/uri-template-expand.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Expand scalar RFC6570 API URL templates without accidental slash or query injection",
            "Construct path and query expressions with explicit reserved expansion"
          ],
          "whenToUse": [
            "Expand scalar RFC6570 API URL templates without accidental slash or query injection",
            "Construct path and query expressions with explicit reserved expansion"
          ],
          "whenNotToUse": [
            "Full RFC6570 level 4, prefix/explode/list/map expansions or arbitrary Unicode template literals",
            "URL authorization, host allowlisting, SSRF safety or fetching"
          ],
          "capabilities": [
            "All eight operators for scalar strings; explicit null/undefined omission",
            "Source: https://www.rfc-editor.org/rfc/rfc6570.html"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "variables": 100,
            "expressions": 100,
            "templateCharacters": 10000,
            "expandedCharacters": 200000
          },
          "related": [
            "url-inspect",
            "querystring-convert",
            "openapi-request-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "template": {
                    "type": "string",
                    "maxLength": 10000
                  },
                  "variables": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 10000
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "template",
                  "variables"
                ],
                "additionalProperties": false
              },
              "example": {
                "template": "https://api.example/items/{id}{?query,cursor}",
                "variables": {
                  "id": "folder/item",
                  "query": "red blue",
                  "cursor": null
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "uri-template-expand",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "rfc6570-scalar-no-modifiers-v1"
                        },
                        "expanded": {
                          "type": "string"
                        },
                        "usedVariables": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "omittedVariables": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "unusedVariables": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "expanded",
                        "usedVariables",
                        "omittedVariables",
                        "unusedVariables"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "uri-template-expand",
                  "version": "0.29.0",
                  "result": {
                    "profile": "rfc6570-scalar-no-modifiers-v1",
                    "expanded": "https://api.example/items/folder%2Fitem?query=red%20blue",
                    "usedVariables": [
                      "id",
                      "query",
                      "cursor"
                    ],
                    "omittedVariables": [
                      "cursor"
                    ],
                    "unusedVariables": []
                  },
                  "provenance": {
                    "inputSha256": "e1935af27af4ababb587b1266ec5524c79d346c9ddb94bc2e6b72cd351c0942b",
                    "outputSha256": "6740b12989926a33df7c5ef4d44a32b7360051d4b52553a4c63bbaac6adcb5f9",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/cloudevents-envelope-check": {
      "post": {
        "operationId": "x402_cloudevents_envelope_check",
        "summary": "CloudEvents JSON Envelope Check",
        "description": "Inspect one structured CloudEvents 1.0 JSON artifact for required attributes, string restrictions, time/calendar profile, data/data_base64 conflicts, canonical Base64 and primary extension mappings. URI checks are ASCII lexical only. No webhook signatures, transport binding, extension semantics or event authenticity checks.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/cloudevents-envelope-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate a supplied CloudEvents structured webhook envelope before ingestion",
            "Detect conflicting CloudEvents payload modes and invalid extension attributes"
          ],
          "whenToUse": [
            "Validate a supplied CloudEvents structured webhook envelope before ingestion",
            "Detect conflicting CloudEvents payload modes and invalid extension attributes"
          ],
          "whenNotToUse": [
            "Authenticating webhook senders, binary HTTP bindings, schema fetching or complete URI conformance",
            "Leap-second validation or secondary structured extension mappings"
          ],
          "capabilities": [
            "Null attributes mean unset; explicit null data remains data",
            "Source: https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/formats/json-format.md"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "events": 1,
            "extensionIntegerMinimum": -2147483648,
            "extensionIntegerMaximum": 2147483647
          },
          "related": [
            "json-schema-check",
            "content-digest",
            "jsonrpc-exchange-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "event": {
                    "$ref": "#/paths/~1v1~1x402~1cloudevents-envelope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "event"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1cloudevents-envelope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1cloudevents-envelope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "event": {
                  "specversion": "1.0",
                  "id": "evt-7",
                  "source": "/agent/orders",
                  "type": "com.example.order.updated",
                  "time": "2026-10-04T12:00:00Z",
                  "datacontenttype": "application/json",
                  "data": {
                    "orderId": "o-2"
                  },
                  "attempt": 1
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "cloudevents-envelope-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "cloudevents-json-envelope-subset-v1"
                        },
                        "identity": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "source": {
                                  "type": "string"
                                },
                                "id": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "source",
                                "id"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "dataMode": {
                          "type": "string",
                          "enum": [
                            "absent",
                            "json",
                            "encoded-string",
                            "base64",
                            "conflict",
                            "unknown"
                          ]
                        },
                        "decodedBytes": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "extensionNames": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "supported": {
                          "type": "boolean"
                        },
                        "valid": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "findings": {
                          "maxItems": 150,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "identity",
                        "dataMode",
                        "decodedBytes",
                        "extensionNames",
                        "supported",
                        "valid",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "cloudevents-envelope-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "cloudevents-json-envelope-subset-v1",
                    "identity": {
                      "source": "/agent/orders",
                      "id": "evt-7"
                    },
                    "dataMode": "json",
                    "decodedBytes": null,
                    "extensionNames": [
                      "attempt"
                    ],
                    "supported": true,
                    "valid": true,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "75566fa290118562edced06b8b2e56383a5815e3567820e673dc69d0bb685abe",
                    "outputSha256": "ab59d76abba7550e73885e13376c82742a6ccac76b210e0c94543bc430baa1b7",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/http-link-parse": {
      "post": {
        "operationId": "x402_http_link_parse",
        "summary": "HTTP Link Header Parser",
        "description": "Parse supplied HTTP Link field values with quote-aware commas, escaped quoted parameters, relations and anchor context. Preserves raw URI references/parameters and first-rel semantics; flags unsupported extended parameters. Does not resolve/fetch links, apply anchors, inspect live pagination or certify full RFC8288 conformance.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-link-parse.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Extract pagination next and last relations from supplied HTTP Link headers",
            "Parse quoted comma parameters and detect anchor-dependent links"
          ],
          "whenToUse": [
            "Extract pagination next and last relations from supplied HTTP Link headers",
            "Parse quoted comma parameters and detect anchor-dependent links"
          ],
          "whenNotToUse": [
            "Following pagination links, URL resolution, link safety or decoding extended title parameters",
            "Treating an anchored link as if it belonged to the original response context"
          ],
          "capabilities": [
            "Raw target and anchor preserved with usableWithoutAnchor flag",
            "Source: https://www.rfc-editor.org/rfc/rfc8288.html"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "headerFields": 20,
            "fieldCharacters": 16000,
            "links": 200,
            "parametersPerLink": 50
          },
          "related": [
            "http-headers-normalize",
            "url-inspect",
            "openapi-response-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "headerValues": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 16000
                    }
                  }
                },
                "required": [
                  "headerValues"
                ],
                "additionalProperties": false
              },
              "example": {
                "headerValues": [
                  "</items?page=2>; rel=\"next\"; title=\"More, items\", </items?page=5>; rel=\"last\""
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-link-parse",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-link-framing-subset-v1"
                        },
                        "links": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "target": {
                                "type": "string"
                              },
                              "relations": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "anchor": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "usableWithoutAnchor": {
                                "type": "boolean"
                              },
                              "parameters": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string"
                                    },
                                    "value": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "target",
                              "relations",
                              "anchor",
                              "usableWithoutAnchor",
                              "parameters"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "supported": {
                          "type": "boolean"
                        },
                        "valid": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "findings": {
                          "maxItems": 150,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "links",
                        "supported",
                        "valid",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-link-parse",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-link-framing-subset-v1",
                    "links": [
                      {
                        "target": "/items?page=2",
                        "relations": [
                          "next"
                        ],
                        "anchor": null,
                        "usableWithoutAnchor": true,
                        "parameters": [
                          {
                            "name": "rel",
                            "value": "next"
                          },
                          {
                            "name": "title",
                            "value": "More, items"
                          }
                        ]
                      },
                      {
                        "target": "/items?page=5",
                        "relations": [
                          "last"
                        ],
                        "anchor": null,
                        "usableWithoutAnchor": true,
                        "parameters": [
                          {
                            "name": "rel",
                            "value": "last"
                          }
                        ]
                      }
                    ],
                    "supported": true,
                    "valid": true,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "936f87f1083a7b82908769f15bbc84a30bcf31f5740b62694bb1b5048d718db6",
                    "outputSha256": "fb895fa83b3582836a18817d4a453dd54e0907b079388c204ad7d5fe27ed7b17",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/http-etag-evaluate": {
      "post": {
        "operationId": "x402_http_etag_evaluate",
        "summary": "HTTP Entity-Tag Preconditions",
        "description": "Evaluate supplied If-Match and If-None-Match against caller-asserted representation existence/current ETag, preserving strong/weak comparison and precondition order. Gives conditional 304/412 or proceed guidance only. Excludes date/range/freshness, duplicate-write exceptions, permission decisions and live requests.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-etag-evaluate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Evaluate conditional HTTP ETag cache validation and optimistic concurrency preconditions",
            "Distinguish weak If-None-Match from strong If-Match and wildcard existence"
          ],
          "whenToUse": [
            "Evaluate conditional HTTP ETag cache validation and optimistic concurrency preconditions",
            "Distinguish weak If-None-Match from strong If-Match and wildcard existence"
          ],
          "whenNotToUse": [
            "Cache freshness, date validators, HTTP ranges, fetching resources or deciding replay authorization",
            "Guaranteed success status or inferring current representation from an ETag alone"
          ],
          "capabilities": [
            "Method tokens are case-sensitive; only uppercase GET/HEAD yield 304",
            "Source: https://www.rfc-editor.org/rfc/rfc9110.html#name-preconditions"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "tagsPerField": 200,
            "fieldCharacters": 16000
          },
          "related": [
            "http-headers-normalize",
            "retry-schedule-plan",
            "openapi-request-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "method": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 32
                  },
                  "representationExists": {
                    "type": "boolean"
                  },
                  "currentEtag": {
                    "type": "string",
                    "maxLength": 4096
                  },
                  "ifMatch": {
                    "type": "string",
                    "maxLength": 16000
                  },
                  "ifNoneMatch": {
                    "type": "string",
                    "maxLength": 16000
                  }
                },
                "required": [
                  "method",
                  "representationExists"
                ],
                "additionalProperties": false
              },
              "example": {
                "method": "GET",
                "representationExists": true,
                "currentEtag": "\"revision-7\"",
                "ifNoneMatch": "W/\"revision-7\""
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-etag-evaluate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-entity-tag-preconditions-v1"
                        },
                        "decision": {
                          "type": "string",
                          "enum": [
                            "proceed",
                            "not-modified",
                            "precondition-failed"
                          ]
                        },
                        "suggestedStatus": {
                          "anyOf": [
                            {
                              "type": "number",
                              "const": 304
                            },
                            {
                              "type": "number",
                              "const": 412
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "evaluated": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "field": {
                                "type": "string",
                                "enum": [
                                  "if-match",
                                  "if-none-match"
                                ]
                              },
                              "comparison": {
                                "type": "string",
                                "enum": [
                                  "strong",
                                  "weak"
                                ]
                              },
                              "passes": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "field",
                              "comparison",
                              "passes"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "assumptions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "decision",
                        "suggestedStatus",
                        "evaluated",
                        "assumptions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-etag-evaluate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-entity-tag-preconditions-v1",
                    "decision": "not-modified",
                    "suggestedStatus": 304,
                    "evaluated": [
                      {
                        "field": "if-none-match",
                        "comparison": "weak",
                        "passes": false
                      }
                    ],
                    "assumptions": [
                      "Normal request checks already succeeded; only If-Match and If-None-Match are evaluated",
                      "Representation selection/existence and current entity-tag are caller assertions",
                      "No date/range/cache-freshness checks, duplicate-write exception, authorization, or network request",
                      "Proceed means these supplied preconditions permit continuing normal request processing, not guaranteed success"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "728b21287315350b2cb828a2620f4e94542eab7bfee981d92d0d2545b552a41d",
                    "outputSha256": "1d723e87ba064217415f2ce5bc9d80034d6a00b041f831924a89bcd55c27e04a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-structural-diff": {
      "post": {
        "operationId": "x402_json_structural_diff",
        "summary": "JSON Structural Patch Generator",
        "description": "Generate deterministic RFC 6902 add/remove/replace operations between supplied JSON values, with recursive object comparison, atomic arrays, escaped pointers and source/target digests. Does not infer moves or produce a minimal edit script.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-structural-diff.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate JSON Patch from two document versions",
            "Find changed nested fields and produce machine-applicable operations"
          ],
          "whenToUse": [
            "Generate JSON Patch from two document versions",
            "Find changed nested fields and produce machine-applicable operations"
          ],
          "whenNotToUse": [
            "Minimal array edit scripts, move detection, or arbitrary-precision JSON numbers",
            "Applying changes to remote files or APIs"
          ],
          "capabilities": [
            "RFC 6902 add/remove/replace output with RFC 6901 pointers",
            "Arrays replaced atomically; object property order ignored",
            "SHA-256 of deterministic sorted-object serialization; not RFC 8785"
          ],
          "related": [
            "json-patch",
            "json-three-way-merge"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "patchOperations": 500,
            "pointerCodeUnits": 2048,
            "patchPayloadBytes": 380000,
            "arrayPolicy": "atomic",
            "digestProfile": "sorted-object-json-utf8-v1"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "PATCH_LIMIT",
            "POINTER_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "before": {
                    "$ref": "#/paths/~1v1~1x402~1json-structural-diff/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "after": {
                    "$ref": "#/paths/~1v1~1x402~1json-structural-diff/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "before",
                  "after"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-structural-diff/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-structural-diff/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "before": {
                  "title": "Draft",
                  "tags": [
                    "review"
                  ],
                  "obsolete": true
                },
                "after": {
                  "title": "Ready",
                  "tags": [
                    "review",
                    "approved"
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-structural-diff",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "object-recursive-array-atomic-diff-v1"
                        },
                        "equal": {
                          "type": "boolean"
                        },
                        "patch": {
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "op": {
                                    "type": "string",
                                    "enum": [
                                      "add",
                                      "replace"
                                    ]
                                  },
                                  "path": {
                                    "type": "string"
                                  },
                                  "value": {
                                    "$ref": "#/paths/~1v1~1x402~1json-structural-diff/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "required": [
                                  "op",
                                  "path",
                                  "value"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "op": {
                                    "type": "string",
                                    "const": "remove"
                                  },
                                  "path": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "op",
                                  "path"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        },
                        "operationCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "sourceSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "targetSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "digestEncoding": {
                          "type": "string",
                          "const": "sorted-object-json-utf8-v1"
                        }
                      },
                      "required": [
                        "profile",
                        "equal",
                        "patch",
                        "operationCount",
                        "sourceSha256",
                        "targetSha256",
                        "digestEncoding"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-structural-diff/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-structural-diff/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-structural-diff",
                  "version": "0.29.0",
                  "result": {
                    "profile": "object-recursive-array-atomic-diff-v1",
                    "equal": false,
                    "patch": [
                      {
                        "op": "remove",
                        "path": "/obsolete"
                      },
                      {
                        "op": "replace",
                        "path": "/tags",
                        "value": [
                          "review",
                          "approved"
                        ]
                      },
                      {
                        "op": "replace",
                        "path": "/title",
                        "value": "Ready"
                      }
                    ],
                    "operationCount": 3,
                    "sourceSha256": "0a34630d562483cee11e48ba6adaeeecceaf6017794835b64d48fd7d81595735",
                    "targetSha256": "d5d727ab6f9598418bfa4c3bfbb83f294f791a046f9a3455baba3cd580c12fa3",
                    "digestEncoding": "sorted-object-json-utf8-v1"
                  },
                  "provenance": {
                    "inputSha256": "1bcf3fa1e1786afa4a3db326acc4a66d1738e5c7d742fac8c26b5393c8ae43ea",
                    "outputSha256": "f105bd87aeb5589d1c84771c0f279373ded003e50d3fd532672e65b7756edc86",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-three-way-merge": {
      "post": {
        "operationId": "x402_json_three_way_merge",
        "summary": "JSON Three-Way Merge",
        "description": "Merge two supplied JSON document branches against an explicit base. Recursively merges object members, treats arrays atomically, distinguishes deletion from null, and returns no merged document when any conflict exists. Does not resolve semantic or textual conflicts.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-three-way-merge.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Merge independent JSON document edits against a common base",
            "Detect delete-versus-modify conflicts before combining agent results"
          ],
          "whenToUse": [
            "Merge independent JSON document edits against a common base",
            "Detect delete-versus-modify conflicts before combining agent results"
          ],
          "whenNotToUse": [
            "CRDT synchronization, line-based text merging or semantic conflict resolution",
            "Element-wise merging of arrays or applying partial conflict results"
          ],
          "capabilities": [
            "Presence-aware conflict snapshots and escaped JSON Pointer paths",
            "Disjoint additions to a new object can merge",
            "Any conflict makes merged and mergedSha256 null; clean distinguishes a legitimate null document"
          ],
          "related": [
            "json-structural-diff",
            "json-patch"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "conflicts": 200,
            "pointerCodeUnits": 2048,
            "conflictPayloadBytes": 380000,
            "arrayPolicy": "atomic",
            "conflictPolicy": "no-partial-result"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "CONFLICT_LIMIT",
            "POINTER_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "base": {
                    "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "ours": {
                    "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "theirs": {
                    "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "base",
                  "ours",
                  "theirs"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "base": {
                  "title": "Draft",
                  "review": {
                    "owner": "Ada",
                    "status": "open"
                  }
                },
                "ours": {
                  "title": "Ready",
                  "review": {
                    "owner": "Ada",
                    "status": "open"
                  }
                },
                "theirs": {
                  "title": "Draft",
                  "review": {
                    "owner": "Ada",
                    "status": "approved"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-three-way-merge",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "three-way-object-merge-v1"
                        },
                        "clean": {
                          "type": "boolean"
                        },
                        "merged": {
                          "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        },
                        "conflicts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "delete-modify",
                                  "concurrent-change"
                                ]
                              },
                              "base": {
                                "type": "object",
                                "properties": {
                                  "exists": {
                                    "type": "boolean"
                                  },
                                  "value": {
                                    "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "required": [
                                  "exists",
                                  "value"
                                ],
                                "additionalProperties": false
                              },
                              "ours": {
                                "type": "object",
                                "properties": {
                                  "exists": {
                                    "type": "boolean"
                                  },
                                  "value": {
                                    "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "required": [
                                  "exists",
                                  "value"
                                ],
                                "additionalProperties": false
                              },
                              "theirs": {
                                "type": "object",
                                "properties": {
                                  "exists": {
                                    "type": "boolean"
                                  },
                                  "value": {
                                    "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "required": [
                                  "exists",
                                  "value"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "path",
                              "kind",
                              "base",
                              "ours",
                              "theirs"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "conflictCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "baseSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "oursSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "theirsSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "mergedSha256": {
                          "anyOf": [
                            {
                              "type": "string",
                              "pattern": "^[a-fA-F0-9]{64}$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "digestEncoding": {
                          "type": "string",
                          "const": "sorted-object-json-utf8-v1"
                        }
                      },
                      "required": [
                        "profile",
                        "clean",
                        "merged",
                        "conflicts",
                        "conflictCount",
                        "baseSha256",
                        "oursSha256",
                        "theirsSha256",
                        "mergedSha256",
                        "digestEncoding"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-three-way-merge",
                  "version": "0.29.0",
                  "result": {
                    "profile": "three-way-object-merge-v1",
                    "clean": true,
                    "merged": {
                      "review": {
                        "owner": "Ada",
                        "status": "approved"
                      },
                      "title": "Ready"
                    },
                    "conflicts": [],
                    "conflictCount": 0,
                    "baseSha256": "4637b695975b02a56c1a9f66ecdd3a736757230debeab5ab8a31ab223dafdeab",
                    "oursSha256": "b1aef96452b997b6b18b042fe24d61b1c0d875e6b8eb02fdcbf90911d48a7306",
                    "theirsSha256": "457e27eeb47fa5a0d1edbb5b1853c5b39ae5c6258275c798c02dfdff3cfc3316",
                    "mergedSha256": "2253f6a38d03688187fbe28688fe40cef7e5fa6a0145241fb257ed8ca972595c",
                    "digestEncoding": "sorted-object-json-utf8-v1"
                  },
                  "provenance": {
                    "inputSha256": "ffc6b6c4229c5d19d1277e4be55dd04320b79b74e3ac625399997ade181953ea",
                    "outputSha256": "6078f9e0ab50af924e599ce85b6c13d2e042ac6795ec40c2b720b0a1ab63e3b5",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/text-edits-apply": {
      "post": {
        "operationId": "x402_text_edits_apply",
        "summary": "Checked Text Edit Application",
        "description": "Atomically apply explicit nonoverlapping UTF-16 text edits after exact expected-slice and optional SHA-256 checks. Returns edited text, applied IDs and unchanged/replacement source mappings. Rejects split Unicode scalars and ambiguous insertion boundaries.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-edits-apply.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Apply agent-proposed document edits with exact source assertions",
            "Produce source-to-result offset evidence for controlled text transformations"
          ],
          "whenToUse": [
            "Apply agent-proposed document edits with exact source assertions",
            "Produce source-to-result offset evidence for controlled text transformations"
          ],
          "whenNotToUse": [
            "Fuzzy matching, natural-language revision or edits to files on disk",
            "Mapping semantic annotations inside replacement text"
          ],
          "capabilities": [
            "Atomic original-source coordinates and expected text on every edit",
            "SHA-256 source/result provenance and explicit mapping segments",
            "No Unicode normalization or newline rewriting"
          ],
          "related": [
            "text-offset-map",
            "document-chunk-audit"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "edits": 200,
            "resultCodeUnits": 200000,
            "offsetUnit": "utf16-code-units"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "DUPLICATE_ID",
            "INVALID_SPAN",
            "INVALID_BOUNDARY",
            "OVERLAPPING_EDITS",
            "EDIT_EXPECTATION_MISMATCH",
            "SOURCE_DIGEST_MISMATCH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "expectedSha256": {
                    "type": "string",
                    "pattern": "^[a-fA-F0-9]{64}$"
                  },
                  "edits": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "expected": {
                          "type": "string",
                          "maxLength": 90000
                        },
                        "replacement": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "id",
                        "start",
                        "end",
                        "expected",
                        "replacement"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "text",
                  "edits"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Status: draft. Owner: Ada.",
                "edits": [
                  {
                    "id": "approve",
                    "start": 8,
                    "end": 13,
                    "expected": "draft",
                    "replacement": "approved"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-edits-apply",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "checked-utf16-edits-v1"
                        },
                        "text": {
                          "type": "string"
                        },
                        "sourceSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "resultSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "appliedEditIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "mapping": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "unchanged",
                                  "replacement"
                                ]
                              },
                              "editId": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "sourceStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "sourceEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "resultStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "resultEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "kind",
                              "editId",
                              "sourceStart",
                              "sourceEnd",
                              "resultStart",
                              "resultEnd"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "text",
                        "sourceSha256",
                        "resultSha256",
                        "appliedEditIds",
                        "mapping"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-edits-apply",
                  "version": "0.29.0",
                  "result": {
                    "profile": "checked-utf16-edits-v1",
                    "text": "Status: approved. Owner: Ada.",
                    "sourceSha256": "337061ebf7debcb2aa7c3c8d377a51252766fe4d8463db95a1e92bde917801b4",
                    "resultSha256": "9a035e2245d18debca13e5035077c0b4f99b15ffbe096a931aa2869948adfbde",
                    "appliedEditIds": [
                      "approve"
                    ],
                    "mapping": [
                      {
                        "kind": "unchanged",
                        "editId": null,
                        "sourceStart": 0,
                        "sourceEnd": 8,
                        "resultStart": 0,
                        "resultEnd": 8
                      },
                      {
                        "kind": "replacement",
                        "editId": "approve",
                        "sourceStart": 8,
                        "sourceEnd": 13,
                        "resultStart": 8,
                        "resultEnd": 16
                      },
                      {
                        "kind": "unchanged",
                        "editId": null,
                        "sourceStart": 13,
                        "sourceEnd": 26,
                        "resultStart": 16,
                        "resultEnd": 29
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "ea5b685091d59b005a2dbb8d8c00538af94be5694555cae5bbef485e8d72fe7f",
                    "outputSha256": "da1702f71331c0a23e70c9f870d9a63e2e3bf4891b0eb3fd6693a1135f1822a5",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/text-offset-map": {
      "post": {
        "operationId": "x402_text_offset_map",
        "summary": "Unicode Evidence Offset Mapping",
        "description": "Translate caller-supplied UTF-8 byte, UTF-16 code-unit or Unicode code-point offsets into all three coordinate systems and LF-based line/column positions. Only exact scalar boundaries are valid; text is never normalized or rewritten.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-offset-map.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Reconcile byte and character offsets from different extraction tools",
            "Convert annotation spans between UTF-8 UTF-16 and code-point systems"
          ],
          "whenToUse": [
            "Reconcile byte and character offsets from different extraction tools",
            "Convert annotation spans between UTF-8 UTF-16 and code-point systems"
          ],
          "whenNotToUse": [
            "Grapheme cluster, display-width, tokenizer or normalization mapping",
            "Offsets into binary files or malformed Unicode"
          ],
          "capabilities": [
            "Rejects offsets inside multibyte UTF-8 sequences or surrogate pairs",
            "Line and column are 1-based; LF starts a new line and CR counts as a scalar",
            "Duplicate offsets preserve caller order"
          ],
          "related": [
            "evidence-quote-check",
            "text-edits-apply"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "offsets": 1000,
            "textCodeUnits": 90000,
            "lineConvention": "1-based-LF-lines-codepoint-columns"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "OFFSET_OUT_OF_RANGE",
            "INVALID_BOUNDARY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "from": {
                    "type": "string",
                    "enum": [
                      "utf16",
                      "utf8",
                      "codepoint"
                    ]
                  },
                  "offsets": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 360000
                    }
                  }
                },
                "required": [
                  "text",
                  "from",
                  "offsets"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "A😀\né",
                "from": "utf8",
                "offsets": [
                  0,
                  1,
                  5,
                  6,
                  8
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-offset-map",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "unicode-scalar-offset-map-v1"
                        },
                        "points": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "input": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "utf16": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "utf8": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "codepoint": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "line": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "column": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "input",
                              "utf16",
                              "utf8",
                              "codepoint",
                              "line",
                              "column"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "totals": {
                          "type": "object",
                          "properties": {
                            "utf16": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "utf8": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "codepoint": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "lines": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "utf16",
                            "utf8",
                            "codepoint",
                            "lines"
                          ],
                          "additionalProperties": false
                        },
                        "lineConvention": {
                          "type": "string",
                          "const": "1-based-LF-lines-codepoint-columns"
                        }
                      },
                      "required": [
                        "profile",
                        "points",
                        "totals",
                        "lineConvention"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-offset-map",
                  "version": "0.29.0",
                  "result": {
                    "profile": "unicode-scalar-offset-map-v1",
                    "points": [
                      {
                        "input": 0,
                        "utf16": 0,
                        "utf8": 0,
                        "codepoint": 0,
                        "line": 1,
                        "column": 1
                      },
                      {
                        "input": 1,
                        "utf16": 1,
                        "utf8": 1,
                        "codepoint": 1,
                        "line": 1,
                        "column": 2
                      },
                      {
                        "input": 5,
                        "utf16": 3,
                        "utf8": 5,
                        "codepoint": 2,
                        "line": 1,
                        "column": 3
                      },
                      {
                        "input": 6,
                        "utf16": 4,
                        "utf8": 6,
                        "codepoint": 3,
                        "line": 2,
                        "column": 1
                      },
                      {
                        "input": 8,
                        "utf16": 5,
                        "utf8": 8,
                        "codepoint": 4,
                        "line": 2,
                        "column": 2
                      }
                    ],
                    "totals": {
                      "utf16": 5,
                      "utf8": 8,
                      "codepoint": 4,
                      "lines": 2
                    },
                    "lineConvention": "1-based-LF-lines-codepoint-columns"
                  },
                  "provenance": {
                    "inputSha256": "b96469ff1344750024c3ccbbc17e975ddfefb337ec5759bfd1515689289beee8",
                    "outputSha256": "1fd72d8c7258d8e48f78132366cde6e3eceece17efe526d8cf9b606f512113ee",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/unified-diff-apply": {
      "post": {
        "operationId": "x402_unified_diff_apply",
        "summary": "Exact Unified Patch Application",
        "description": "Apply a single-file supplied unified diff to supplied LF text with exact old/new hunk positions, exact context matching, final-newline markers and optional source digest/label assertions. Labels are inert metadata. No fuzzy offsets, Git prelude, filesystem writes or external content.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/unified-diff-apply.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate and apply a model-generated unified patch to supplied document text",
            "Reject stale patch context before accepting a document revision"
          ],
          "whenToUse": [
            "Validate and apply a model-generated unified patch to supplied document text",
            "Reject stale patch context before accepting a document revision"
          ],
          "whenNotToUse": [
            "Multi-file patches, Git binary patches, rename metadata, fuzz or CRLF text",
            "Filesystem access, path safety validation, or applying a patch to a repository"
          ],
          "capabilities": [
            "Single ---/+++ header pair and at most 200 exact-position hunks",
            "LF-only text with GNU no-newline markers",
            "New hunk positions must match accumulated line deltas"
          ],
          "related": [
            "lines-diff",
            "text-edits-apply"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "hunks": 200,
            "sourceLines": 10000,
            "resultLines": 10000,
            "patchLines": 20000,
            "lineEndings": "LF-only"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "UNSUPPORTED_LINE_ENDING",
            "INVALID_PATCH",
            "LINE_LIMIT",
            "HUNK_LIMIT",
            "HUNK_RANGE_MISMATCH",
            "PATCH_CONTEXT_MISMATCH",
            "PATCH_LABEL_MISMATCH",
            "SOURCE_DIGEST_MISMATCH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "patch": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "expectedSha256": {
                    "type": "string",
                    "pattern": "^[a-fA-F0-9]{64}$"
                  },
                  "expectedOldLabel": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 512
                  }
                },
                "required": [
                  "text",
                  "patch"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Title\nDraft\n",
                "patch": "--- memo.txt\n+++ memo.txt\n@@ -1,2 +1,2 @@\n Title\n-Draft\n+Approved\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "unified-diff-apply",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "single-file-exact-unified-v1"
                        },
                        "text": {
                          "type": "string"
                        },
                        "oldLabel": {
                          "type": "string"
                        },
                        "newLabel": {
                          "type": "string"
                        },
                        "sourceSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "resultSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "hunks": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "oldStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "oldCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "newStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "newCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "added": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "removed": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "context": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "oldStart",
                              "oldCount",
                              "newStart",
                              "newCount",
                              "added",
                              "removed",
                              "context"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "addedLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "removedLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "profile",
                        "text",
                        "oldLabel",
                        "newLabel",
                        "sourceSha256",
                        "resultSha256",
                        "hunks",
                        "addedLines",
                        "removedLines"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "unified-diff-apply",
                  "version": "0.29.0",
                  "result": {
                    "profile": "single-file-exact-unified-v1",
                    "text": "Title\nApproved\n",
                    "oldLabel": "memo.txt",
                    "newLabel": "memo.txt",
                    "sourceSha256": "a9f5e927daf42ccddfd5b3d32339fc81e8a2542fa4e3034818c1e74c83d93d90",
                    "resultSha256": "784e8c6360e6639a1996ceea7e1f0c07d5a81d6b37bd100fc2143774af9b1f19",
                    "hunks": [
                      {
                        "oldStart": 1,
                        "oldCount": 2,
                        "newStart": 1,
                        "newCount": 2,
                        "added": 1,
                        "removed": 1,
                        "context": 1
                      }
                    ],
                    "addedLines": 1,
                    "removedLines": 1
                  },
                  "provenance": {
                    "inputSha256": "90c3e1079c87b9e2946db7c3a80a0106c364f3f90dab9ae89143cc4ae1d7b2fd",
                    "outputSha256": "46af28a70cd21a1ab902e6cb5af4cd38dc3def274362e3bffdfed748131c181c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/markdown-table-extract": {
      "post": {
        "operationId": "x402_markdown_table_extract",
        "summary": "Markdown Pipe Table Extraction",
        "description": "Extract top-level pipe tables from supplied Markdown into bounded cell arrays with exact source offsets, alignment and width findings. Uses an explicit line-based subset: table starts at document start or after a blank line, three-hyphen delimiters, fences excluded, inline markup preserved.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/markdown-table-extract.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Extract structured rows and cell provenance from Markdown reports",
            "Check pipe table widths without silently dropping or padding cells"
          ],
          "whenToUse": [
            "Extract structured rows and cell provenance from Markdown reports",
            "Check pipe table widths without silently dropping or padding cells"
          ],
          "whenNotToUse": [
            "Full CommonMark or GFM parsing, nested containers, HTML tables or inline rendering",
            "Automatic schema inference, typed values or ambiguous one-hyphen delimiters"
          ],
          "capabilities": [
            "Backslash-escaped pipes and optional outer pipes",
            "Fenced code is excluded; inline backticks do not protect an unescaped pipe",
            "Raw cell slices preserved with UTF-16 offsets; malformed row widths remain visible"
          ],
          "related": [
            "csv-serialize",
            "record-constraints"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "tables": 50,
            "rowsPerTable": 500,
            "columns": 50,
            "cells": 5000,
            "lines": 10000,
            "profile": "top-level-pipe-tables-v1"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "LINE_LIMIT",
            "TABLE_LIMIT",
            "ROW_LIMIT",
            "CELL_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string",
                    "maxLength": 90000
                  }
                },
                "required": [
                  "markdown"
                ],
                "additionalProperties": false
              },
              "example": {
                "markdown": "| Item | State |\n| :--- | ---: |\n| Report | approved |\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "markdown-table-extract",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "top-level-pipe-tables-v1"
                        },
                        "tables": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "startLine": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "endLine": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "header": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "raw": {
                                      "type": "string"
                                    },
                                    "text": {
                                      "type": "string"
                                    },
                                    "start": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "end": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "raw",
                                    "text",
                                    "start",
                                    "end"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "alignment": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "left",
                                    "center",
                                    "right",
                                    "none"
                                  ]
                                }
                              },
                              "rows": {
                                "type": "array",
                                "items": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "raw": {
                                        "type": "string"
                                      },
                                      "text": {
                                        "type": "string"
                                      },
                                      "start": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "end": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "raw",
                                      "text",
                                      "start",
                                      "end"
                                    ],
                                    "additionalProperties": false
                                  }
                                }
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "startLine",
                              "endLine",
                              "header",
                              "alignment",
                              "rows"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "tableCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "cellCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "tables",
                        "tableCount",
                        "cellCount",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "markdown-table-extract",
                  "version": "0.29.0",
                  "result": {
                    "profile": "top-level-pipe-tables-v1",
                    "tables": [
                      {
                        "start": 0,
                        "end": 54,
                        "startLine": 1,
                        "endLine": 3,
                        "header": [
                          {
                            "raw": "Item",
                            "text": "Item",
                            "start": 2,
                            "end": 6
                          },
                          {
                            "raw": "State",
                            "text": "State",
                            "start": 9,
                            "end": 14
                          }
                        ],
                        "alignment": [
                          "left",
                          "right"
                        ],
                        "rows": [
                          [
                            {
                              "raw": "Report",
                              "text": "Report",
                              "start": 35,
                              "end": 41
                            },
                            {
                              "raw": "approved",
                              "text": "approved",
                              "start": 44,
                              "end": 52
                            }
                          ]
                        ]
                      }
                    ],
                    "tableCount": 1,
                    "cellCount": 4,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "9f9d5f26b45ac5623ed318d00210ca35ead401a4330a17032bb62cf64f226f7a",
                    "outputSha256": "001672fc563cbade4eff0027b426283e54ddd7e9e26800b5033cbab8f9a65fe8",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/document-chunk-audit": {
      "post": {
        "operationId": "x402_document_chunk_audit",
        "summary": "Document Chunk Integrity Audit",
        "description": "Audit supplied retrieval/document chunks against their exact source spans and compute verified coverage, uncovered ranges, overlap depth and policy findings. Invalid chunks never contribute coverage. Checks identity and coverage only, not retrieval quality or semantic relevance.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/document-chunk-audit.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Verify exported RAG chunks reconstruct and cover their source document",
            "Find stale chunk text, gaps or forbidden overlaps before indexing"
          ],
          "whenToUse": [
            "Verify exported RAG chunks reconstruct and cover their source document",
            "Find stale chunk text, gaps or forbidden overlaps before indexing"
          ],
          "whenNotToUse": [
            "Semantic chunk quality, source authenticity, OCR correction or embedding validation",
            "Comparing independent ground-truth annotation datasets"
          ],
          "capabilities": [
            "Only exact nonempty scalar-aligned UTF-16 spans count toward coverage",
            "Sweep-line union, gap and overlap-depth evidence",
            "Full coverage and overlap policies supplied explicitly; defaults require full coverage and permit overlap"
          ],
          "related": [
            "text-chunk",
            "text-offset-map",
            "evidence-quote-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "chunks": 200,
            "offsetUnit": "utf16-code-units",
            "coverageUnit": "utf16-code-units"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "DUPLICATE_ID"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "chunks": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "id",
                        "start",
                        "end",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "requireFullCoverage": {
                    "default": true,
                    "type": "boolean"
                  },
                  "allowOverlap": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text",
                  "chunks"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "alpha beta gamma",
                "chunks": [
                  {
                    "id": "a",
                    "start": 0,
                    "end": 10,
                    "text": "alpha beta"
                  },
                  {
                    "id": "b",
                    "start": 6,
                    "end": 16,
                    "text": "beta gamma"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "document-chunk-audit",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "exact-chunk-coverage-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "sourceSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "statuses": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "verified",
                                  "invalid-span",
                                  "invalid-boundary",
                                  "text-mismatch"
                                ]
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "id",
                              "status",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "coverage": {
                          "type": "object",
                          "properties": {
                            "sourceCodeUnits": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "coveredCodeUnits": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "uncoveredCodeUnits": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "overlapCodeUnits": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "maxDepth": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "sourceCodeUnits",
                            "coveredCodeUnits",
                            "uncoveredCodeUnits",
                            "overlapCodeUnits",
                            "maxDepth"
                          ],
                          "additionalProperties": false
                        },
                        "uncoveredRanges": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "overlapRanges": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "depth": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "depth"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "sourceSha256",
                        "statuses",
                        "coverage",
                        "uncoveredRanges",
                        "overlapRanges",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "document-chunk-audit",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-chunk-coverage-v1",
                    "passesChecks": true,
                    "sourceSha256": "64989ccbf3efa9c84e2afe7cee9bc5828bf0fcb91e44f8c1e591638a2c2e90e3",
                    "statuses": [
                      {
                        "id": "a",
                        "status": "verified",
                        "start": 0,
                        "end": 10
                      },
                      {
                        "id": "b",
                        "status": "verified",
                        "start": 6,
                        "end": 16
                      }
                    ],
                    "coverage": {
                      "sourceCodeUnits": 16,
                      "coveredCodeUnits": 16,
                      "uncoveredCodeUnits": 0,
                      "overlapCodeUnits": 4,
                      "maxDepth": 2
                    },
                    "uncoveredRanges": [],
                    "overlapRanges": [
                      {
                        "start": 6,
                        "end": 10,
                        "depth": 2
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "59c3081b39fdd0d1ef5e92076e1b1c3d94fcaa08cc2e15812f54899641206e40",
                    "outputSha256": "b3decc82c492c41aad32fe3b5ac6e6e3cf20184f05ced3d5b32faeb010d8cd72",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-document-extract": {
      "post": {
        "operationId": "x402_json_document_extract",
        "summary": "Strict JSON Artifact Extraction",
        "description": "Extract exact JSON object/array candidates from caller-supplied text using explicit json-fence or balanced-container mode. Selects only one unambiguous valid candidate, rejects duplicate decoded keys and nonfinite numbers, and never repairs invalid JSON or executes content.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-document-extract.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Recover a strict JSON object from a model response with source-span evidence",
            "Reject ambiguous structured outputs instead of choosing the first JSON block"
          ],
          "whenToUse": [
            "Recover a strict JSON object from a model response with source-span evidence",
            "Reject ambiguous structured outputs instead of choosing the first JSON block"
          ],
          "whenNotToUse": [
            "JSON repair, JSON5, primitive JSON roots, schema validation or interpreting prose",
            "Guaranteed distinction between literal braces in prose and intended JSON in balanced mode"
          ],
          "capabilities": [
            "Case-sensitive json-labelled backtick/tilde fences; other fenced languages ignored",
            "Balanced mode respects JSON strings inside candidate containers",
            "Any malformed candidate or unmatched close blocks selection; multiple valid candidates are ambiguous",
            "Duplicate decoded keys, unsafe keys, unpaired surrogates and nonfinite numbers rejected"
          ],
          "related": [
            "json-schema-check",
            "mcp-result-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "candidates": 20,
            "parsedJsonNodes": 8000,
            "lines": 10000,
            "jsonRepair": "none",
            "primitiveRoots": "unsupported"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "CANDIDATE_LIMIT",
            "LINE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "json-fences",
                      "balanced-containers"
                    ]
                  }
                },
                "required": [
                  "text",
                  "mode"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Result:\n```json\n{\"approved\":true,\"items\":[1,2]}\n```\n",
                "mode": "json-fences"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-document-extract",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "exact-json-container-extraction-v1"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "selected",
                            "none",
                            "ambiguous",
                            "invalid"
                          ]
                        },
                        "selected": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "start": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "end": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "value": {
                                  "$ref": "#/paths/~1v1~1x402~1json-document-extract/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                }
                              },
                              "required": [
                                "start",
                                "end",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "candidates": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "valid": {
                                "type": "boolean"
                              },
                              "value": {
                                "$ref": "#/paths/~1v1~1x402~1json-document-extract/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              },
                              "errorCode": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "valid",
                              "value",
                              "errorCode"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "candidateCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "selected",
                        "candidates",
                        "candidateCount",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-document-extract/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-document-extract/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-document-extract",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-json-container-extraction-v1",
                    "status": "selected",
                    "selected": {
                      "start": 16,
                      "end": 47,
                      "value": {
                        "approved": true,
                        "items": [
                          1,
                          2
                        ]
                      }
                    },
                    "candidates": [
                      {
                        "start": 16,
                        "end": 47,
                        "valid": true,
                        "value": {
                          "approved": true,
                          "items": [
                            1,
                            2
                          ]
                        },
                        "errorCode": null
                      }
                    ],
                    "candidateCount": 1,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "735ea43dca3f31b041cd1e74c267c918a2de412c0f44fdfff7541b2286b214e1",
                    "outputSha256": "e7e8de0d5cc2af865f62303ee36cd38d45b5ad7104fa401b28fee59c8b308476",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-repair": {
      "post": {
        "operationId": "x402_json_repair",
        "summary": "Conservative JSON Repair Batch",
        "description": "Repair 1–5 supplied JSON-like texts under an explicit conservative grammar: comments, trailing commas, ASCII unquoted keys, single quotes, Python True/False/None, leading BOM and one enclosing JSON fence. Return unchanged originals, repaired text, parsed values, exact edit traces and independent item rejections. No missing values, delimiters or truncated data are inferred.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-repair.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Repair bounded malformed JSON with an exact edit trace",
            "Batch up to five independent JSON syntax repairs"
          ],
          "whenToUse": [
            "Repair known syntactic defects in caller-supplied JSON-like text",
            "Preserve original text and inspect every change before trusting a structured artifact"
          ],
          "whenNotToUse": [
            "Arbitrary JSON5 or Python parsing, schema validation, semantic correction or guaranteed repair",
            "Completing truncated values, guessing missing delimiters or selecting duplicate keys",
            "Large documents, arbitrary-precision numbers or a cheapest single-call guarantee"
          ],
          "capabilities": [
            "One fixed proposed price for 1–5 items with independent success/rejected results",
            "Explicit repair profile and complete nonoverlapping original-coordinate UTF-16 edits",
            "Preserves valid number tokens and unchanged valid JSON text; rejects unsafe or decimal-round-trip-changing numbers",
            "Rejects decoded duplicate/reserved keys and invalid Unicode; never executes supplied text"
          ],
          "limits": {
            "items": 5,
            "textCodeUnitsPerItem": 16000,
            "inputBytes": 100000,
            "outputBytes": 400000,
            "nodesPerItem": 4000,
            "depth": 20,
            "editsPerItem": 200,
            "numberTokenCodeUnits": 256,
            "profile": "conservative-json-repair-v1",
            "offsetUnit": "utf16-code-units",
            "networkAccess": "none",
            "schemaValidation": "not-performed"
          },
          "related": [
            "json-document-extract",
            "json-schema-check",
            "json-canonicalize"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "DUPLICATE_ID",
            "EDIT_LIMIT",
            "COMPLEXITY_LIMIT",
            "NUMBER_LIMIT",
            "NON_FINITE_NUMBER",
            "UNSAFE_INTEGER",
            "NUMBER_PRECISION",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_KEY",
            "UNSUPPORTED_FENCE",
            "UNTERMINATED_COMMENT",
            "UNSUPPORTED_COMMENT",
            "INVALID_STRING",
            "INVALID_ESCAPE",
            "TRUNCATED_STRING",
            "TRUNCATED_VALUE",
            "TRUNCATED_CONTAINER",
            "MISSING_COLON",
            "MISSING_COMMA",
            "UNSUPPORTED_KEY",
            "UNSUPPORTED_SYNTAX",
            "TRAILING_CONTENT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "string",
                    "const": "conservative-json-repair-v1"
                  },
                  "items": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80,
                          "pattern": "^[A-Za-z0-9_-]+$"
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 16000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "profile",
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile": "conservative-json-repair-v1",
                "items": [
                  {
                    "id": "paid-fixture",
                    "text": "{foo: 'bar', broken: true,}"
                  },
                  {
                    "id": "already-valid",
                    "text": "{\"items\":[1,2],\"ok\":true}"
                  },
                  {
                    "id": "truncated",
                    "text": "{\"name\":\"unfinished"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-repair",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "conservative-json-repair-v1"
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "utf16-code-units"
                        },
                        "itemCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 5
                        },
                        "successCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "rejectedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "results": {
                          "minItems": 1,
                          "maxItems": 5,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 80,
                                    "pattern": "^[A-Za-z0-9_-]+$"
                                  },
                                  "originalText": {
                                    "type": "string"
                                  },
                                  "status": {
                                    "type": "string",
                                    "enum": [
                                      "repaired",
                                      "unchanged"
                                    ]
                                  },
                                  "originalSha256": {
                                    "type": "string",
                                    "pattern": "^[a-f0-9]{64}$"
                                  },
                                  "originalWasValidJson": {
                                    "type": "boolean"
                                  },
                                  "repairedText": {
                                    "type": "string"
                                  },
                                  "repairedSha256": {
                                    "type": "string",
                                    "pattern": "^[a-f0-9]{64}$"
                                  },
                                  "value": {
                                    "$ref": "#/paths/~1v1~1x402~1json-repair/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  },
                                  "edits": {
                                    "maxItems": 200,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "remove-bom",
                                            "remove-fence",
                                            "replace-comment",
                                            "remove-trailing-comma",
                                            "quote-key",
                                            "convert-single-quoted-string",
                                            "convert-python-literal"
                                          ]
                                        },
                                        "start": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "end": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "before": {
                                          "type": "string"
                                        },
                                        "after": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "start",
                                        "end",
                                        "before",
                                        "after"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "originalText",
                                  "status",
                                  "originalSha256",
                                  "originalWasValidJson",
                                  "repairedText",
                                  "repairedSha256",
                                  "value",
                                  "edits"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 80,
                                    "pattern": "^[A-Za-z0-9_-]+$"
                                  },
                                  "originalText": {
                                    "type": "string"
                                  },
                                  "status": {
                                    "type": "string",
                                    "const": "rejected"
                                  },
                                  "originalSha256": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "pattern": "^[a-f0-9]{64}$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "error": {
                                    "type": "object",
                                    "properties": {
                                      "code": {
                                        "type": "string"
                                      },
                                      "message": {
                                        "type": "string"
                                      },
                                      "offset": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "code",
                                      "message",
                                      "offset"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "required": [
                                  "id",
                                  "originalText",
                                  "status",
                                  "originalSha256",
                                  "error"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "offsetUnit",
                        "itemCount",
                        "successCount",
                        "rejectedCount",
                        "results"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-repair/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-repair/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-repair",
                  "version": "0.29.0",
                  "result": {
                    "profile": "conservative-json-repair-v1",
                    "offsetUnit": "utf16-code-units",
                    "itemCount": 3,
                    "successCount": 2,
                    "rejectedCount": 1,
                    "results": [
                      {
                        "id": "paid-fixture",
                        "originalText": "{foo: 'bar', broken: true,}",
                        "status": "repaired",
                        "originalSha256": "180949792a87351e726ae3e5ea90bfa3ecf362028e987b6edce90abe359c0b2f",
                        "originalWasValidJson": false,
                        "repairedText": "{\"foo\": \"bar\", \"broken\": true}",
                        "repairedSha256": "a5640e8bcad859bf34dc8849af8f22a455c7dbd86f81a83287666b3dc0bb6eeb",
                        "value": {
                          "foo": "bar",
                          "broken": true
                        },
                        "edits": [
                          {
                            "kind": "quote-key",
                            "start": 1,
                            "end": 4,
                            "before": "foo",
                            "after": "\"foo\""
                          },
                          {
                            "kind": "convert-single-quoted-string",
                            "start": 6,
                            "end": 11,
                            "before": "'bar'",
                            "after": "\"bar\""
                          },
                          {
                            "kind": "quote-key",
                            "start": 13,
                            "end": 19,
                            "before": "broken",
                            "after": "\"broken\""
                          },
                          {
                            "kind": "remove-trailing-comma",
                            "start": 25,
                            "end": 26,
                            "before": ",",
                            "after": ""
                          }
                        ]
                      },
                      {
                        "id": "already-valid",
                        "originalText": "{\"items\":[1,2],\"ok\":true}",
                        "status": "unchanged",
                        "originalSha256": "067816002380371fc6726553d6797b9cddfb32289bc801f9a82612f09f74e5d4",
                        "originalWasValidJson": true,
                        "repairedText": "{\"items\":[1,2],\"ok\":true}",
                        "repairedSha256": "067816002380371fc6726553d6797b9cddfb32289bc801f9a82612f09f74e5d4",
                        "value": {
                          "items": [
                            1,
                            2
                          ],
                          "ok": true
                        },
                        "edits": []
                      },
                      {
                        "id": "truncated",
                        "originalText": "{\"name\":\"unfinished",
                        "status": "rejected",
                        "originalSha256": "24f03ddd7eff759bda2f2f10cae68b37cc828cf219b149b3011577819c32b8f3",
                        "error": {
                          "code": "TRUNCATED_STRING",
                          "message": "Missing string closing quote; no value is inferred",
                          "offset": 8
                        }
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "a2c462b8c4f3bb0e6a6b0c6f4d34ad90507da1a4e1b48ac23a5d571ef2802b46",
                    "outputSha256": "6aa3bc1bf9fbc05627e4cf7534f8e8bf280ca6614eb13213262cf2e6479987dc",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/email-domain-readiness": {
      "post": {
        "operationId": "x402_email_domain_readiness",
        "summary": "Public email-domain DNS readiness",
        "description": "Inspect one public ASCII domain's live MX, null MX, or implicit A/AAAA fallback with resolver/time/TTL evidence. Domain only; no email address, mailbox, deliverability, disposable/free-provider or role classification. x402 only.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/email-domain-readiness.md"
        },
        "x-agent-discovery": {
          "intents": [
            "check email domain DNS readiness",
            "live MX record lookup",
            "detect null MX domain",
            "check implicit mail A AAAA fallback"
          ],
          "whenToUse": [
            "Inspect public-domain mail-routing DNS records with bounded live resolver evidence."
          ],
          "whenNotToUse": [
            "Full email validation, mailbox existence, SMTP delivery tests, disposable/free-provider/role classification, MX-host reachability, arbitrary DNS record types, private DNS, internationalized Unicode input, or guaranteed DNS freshness."
          ],
          "capabilities": [
            "email-domain-readiness",
            "public DNS MX",
            "null MX",
            "implicit A AAAA fallback",
            "NXDOMAIN",
            "resolver timestamp TTL"
          ],
          "related": [
            "url-inspect"
          ],
          "limits": {
            "queries": 3,
            "queryTimeoutMs": 1500,
            "totalTimeoutMs": 5000,
            "resolverResponseBytes": 32768,
            "recordsPerQuery": 64,
            "outputBytes": 32768
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_DOMAIN",
            "UNSUPPORTED_DOMAIN",
            "DNS_BUSY",
            "DNS_TIMEOUT",
            "DNS_SERVFAIL",
            "DNS_UNAVAILABLE",
            "DNS_HTTP_ERROR",
            "DNS_TRUNCATED",
            "DNS_INVALID_RESPONSE",
            "DNS_INCONSISTENT_RESPONSE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "domain": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 254
                  }
                },
                "required": [
                  "domain"
                ],
                "additionalProperties": false
              },
              "example": {
                "domain": "example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "email-domain-readiness",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "public-email-domain-dns-v1"
                        },
                        "domain": {
                          "type": "string",
                          "maxLength": 253
                        },
                        "canonicalDomain": {
                          "type": "string",
                          "maxLength": 253
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "mx_records",
                            "null_mx",
                            "implicit_mx",
                            "no_mail_route",
                            "nxdomain",
                            "inconsistent_mx"
                          ]
                        },
                        "mxRecords": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "preference": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 65535
                              },
                              "exchange": {
                                "type": "string",
                                "maxLength": 253
                              },
                              "ttlSeconds": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 2147483647
                              }
                            },
                            "required": [
                              "preference",
                              "exchange",
                              "ttlSeconds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "implicitAddresses": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "A",
                                  "AAAA"
                                ]
                              },
                              "address": {
                                "type": "string",
                                "maxLength": 45
                              },
                              "ttlSeconds": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 2147483647
                              }
                            },
                            "required": [
                              "type",
                              "address",
                              "ttlSeconds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "observations": {
                          "minItems": 1,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "maxLength": 253
                              },
                              "type": {
                                "type": "string",
                                "enum": [
                                  "MX",
                                  "A",
                                  "AAAA"
                                ]
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "NOERROR",
                                  "NXDOMAIN"
                                ]
                              },
                              "canonicalName": {
                                "type": "string",
                                "maxLength": 253
                              },
                              "observedAt": {
                                "type": "string",
                                "format": "date-time",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                              },
                              "resolver": {
                                "type": "string",
                                "const": "https://dns.google/resolve"
                              },
                              "resolverDnssecAuthenticated": {
                                "type": "boolean"
                              },
                              "records": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "maxLength": 253
                                    },
                                    "type": {
                                      "type": "string",
                                      "enum": [
                                        "CNAME",
                                        "MX",
                                        "A",
                                        "AAAA"
                                      ]
                                    },
                                    "data": {
                                      "type": "string",
                                      "maxLength": 512
                                    },
                                    "ttlSeconds": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 2147483647
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "type",
                                    "data",
                                    "ttlSeconds"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "minimumAnswerTtlSeconds": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 2147483647
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "type",
                              "status",
                              "canonicalName",
                              "observedAt",
                              "resolver",
                              "resolverDnssecAuthenticated",
                              "records",
                              "minimumAnswerTtlSeconds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "externalRequests": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 3
                        },
                        "observedAt": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        "applicationDnsCache": {
                          "type": "string",
                          "const": "none"
                        },
                        "ttlPolicy": {
                          "type": "string",
                          "const": "remaining-resolver-answer-ttl-at-observation; replay-does-not-refresh"
                        },
                        "mailboxExistence": {
                          "type": "string",
                          "const": "not_checked"
                        },
                        "deliverability": {
                          "type": "string",
                          "const": "not_checked"
                        },
                        "mxHostAddresses": {
                          "type": "string",
                          "const": "not_checked"
                        },
                        "providerClassification": {
                          "type": "string",
                          "const": "not_checked"
                        }
                      },
                      "required": [
                        "profile",
                        "domain",
                        "canonicalDomain",
                        "status",
                        "mxRecords",
                        "implicitAddresses",
                        "observations",
                        "externalRequests",
                        "observedAt",
                        "applicationDnsCache",
                        "ttlPolicy",
                        "mailboxExistence",
                        "deliverability",
                        "mxHostAddresses",
                        "providerClassification"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": false
                        },
                        "externalRequests": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 3
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "email-domain-readiness",
                  "version": "0.29.0",
                  "result": {
                    "profile": "public-email-domain-dns-v1",
                    "domain": "example.com",
                    "canonicalDomain": "example.com",
                    "status": "null_mx",
                    "mxRecords": [
                      {
                        "preference": 0,
                        "exchange": ".",
                        "ttlSeconds": 300
                      }
                    ],
                    "implicitAddresses": [],
                    "observations": [
                      {
                        "name": "example.com",
                        "type": "MX",
                        "status": "NOERROR",
                        "canonicalName": "example.com",
                        "observedAt": "2026-10-04T00:00:00.000Z",
                        "resolver": "https://dns.google/resolve",
                        "resolverDnssecAuthenticated": false,
                        "records": [
                          {
                            "name": "example.com",
                            "type": "MX",
                            "data": "0 .",
                            "ttlSeconds": 300
                          }
                        ],
                        "minimumAnswerTtlSeconds": 300
                      }
                    ],
                    "externalRequests": 1,
                    "observedAt": "2026-10-04T00:00:00.000Z",
                    "applicationDnsCache": "none",
                    "ttlPolicy": "remaining-resolver-answer-ttl-at-observation; replay-does-not-refresh",
                    "mailboxExistence": "not_checked",
                    "deliverability": "not_checked",
                    "mxHostAddresses": "not_checked",
                    "providerClassification": "not_checked"
                  },
                  "provenance": {
                    "inputSha256": "b9e2a80fa92f8d5059ab90188e0691ad6730871a209cc337c7565593597fbd58",
                    "outputSha256": "a7f5f263fc806b983907b619b6775fdeb681822afd1cea09f45cd835e53ac3a9",
                    "deterministic": false,
                    "externalRequests": 1
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.002",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/timezone-convert": {
      "post": {
        "operationId": "x402_timezone_convert",
        "summary": "UTC instant to IANA time zones",
        "description": "Convert one explicit UTC instant into 1–10 IANA zone local times and exact UTC offsets, including the runtime's daylight-saving transitions. No wall-time guessing, current-clock lookup, recurrence or DST boolean. Runtime tzdb version is not exposed.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/timezone-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert UTC instant to IANA time zones",
            "batch timezone conversion",
            "UTC local time daylight saving offset",
            "format instant in multiple zones"
          ],
          "whenToUse": [
            "Convert one supplied UTC instant to 1–10 local representations with second-accurate offsets under the installed runtime IANA data."
          ],
          "whenNotToUse": [
            "Resolve an ambiguous or nonexistent local wall time, infer a city or abbreviation, fetch current time, classify DST with a boolean, schedule recurring events, or guarantee historical/future political time-zone rules."
          ],
          "capabilities": [
            "UTC instant",
            "IANA time zones",
            "batch zone conversion",
            "local date and time",
            "daylight-saving offset transitions",
            "fractional-hour offsets"
          ],
          "related": [
            "timestamp-convert",
            "duration-convert"
          ],
          "limits": {
            "zones": 10,
            "zoneCodeUnits": 64,
            "outputBytes": 16000,
            "earliestUtc": "1970-01-01T00:00:00.000Z",
            "latestUtc": "2100-12-31T23:59:59.999Z",
            "precision": "milliseconds",
            "tzdbVersion": "not exposed; depends on runtime"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_INSTANT",
            "DUPLICATE_TIME_ZONE",
            "UNSUPPORTED_TIME_ZONE",
            "TIME_ZONE_RUNTIME_ERROR"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "string",
                    "const": "utc-instant-iana-batch-v1"
                  },
                  "instant": {
                    "type": "string",
                    "minLength": 20,
                    "maxLength": 24,
                    "pattern": "^(?:19[7-9]\\d|20\\d{2}|2100)-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?Z$"
                  },
                  "zones": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64,
                      "pattern": "^(?:UTC|[A-Za-z][A-Za-z0-9._+-]*(?:\\/[A-Za-z0-9._+-]+)+)$"
                    }
                  }
                },
                "required": [
                  "profile",
                  "instant",
                  "zones"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile": "utc-instant-iana-batch-v1",
                "instant": "2026-07-01T12:00:00Z",
                "zones": [
                  "America/New_York",
                  "Europe/London",
                  "Asia/Kolkata",
                  "Pacific/Auckland"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "timezone-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "utc-instant-iana-batch-v1"
                        },
                        "instant": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        "epochMilliseconds": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "zoneCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10
                        },
                        "rulesSource": {
                          "type": "string",
                          "const": "runtime-intl-iana"
                        },
                        "tzdbVersion": {
                          "type": "null"
                        },
                        "dstPolicy": {
                          "type": "string",
                          "const": "offset-at-instant; no-heuristic-DST-classification"
                        },
                        "results": {
                          "minItems": 1,
                          "maxItems": 10,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "requestedZone": {
                                "type": "string",
                                "maxLength": 64
                              },
                              "resolvedZone": {
                                "type": "string",
                                "maxLength": 64
                              },
                              "localDateTime": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}$"
                              },
                              "utcOffset": {
                                "type": "string",
                                "pattern": "^[+-]\\d{2}:\\d{2}(?::\\d{2})?$"
                              },
                              "utcOffsetSeconds": {
                                "type": "integer",
                                "minimum": -86400,
                                "maximum": 86400
                              },
                              "zonedDateTime": {
                                "type": "string",
                                "maxLength": 110
                              }
                            },
                            "required": [
                              "requestedZone",
                              "resolvedZone",
                              "localDateTime",
                              "utcOffset",
                              "utcOffsetSeconds",
                              "zonedDateTime"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "instant",
                        "epochMilliseconds",
                        "zoneCount",
                        "rulesSource",
                        "tzdbVersion",
                        "dstPolicy",
                        "results"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "timezone-convert",
                  "version": "0.29.0",
                  "result": {
                    "profile": "utc-instant-iana-batch-v1",
                    "instant": "2026-07-01T12:00:00.000Z",
                    "epochMilliseconds": 1782907200000,
                    "zoneCount": 4,
                    "rulesSource": "runtime-intl-iana",
                    "tzdbVersion": null,
                    "dstPolicy": "offset-at-instant; no-heuristic-DST-classification",
                    "results": [
                      {
                        "requestedZone": "America/New_York",
                        "resolvedZone": "America/New_York",
                        "localDateTime": "2026-07-01T08:00:00.000",
                        "utcOffset": "-04:00",
                        "utcOffsetSeconds": -14400,
                        "zonedDateTime": "2026-07-01T08:00:00.000-04:00[America/New_York]"
                      },
                      {
                        "requestedZone": "Europe/London",
                        "resolvedZone": "Europe/London",
                        "localDateTime": "2026-07-01T13:00:00.000",
                        "utcOffset": "+01:00",
                        "utcOffsetSeconds": 3600,
                        "zonedDateTime": "2026-07-01T13:00:00.000+01:00[Europe/London]"
                      },
                      {
                        "requestedZone": "Asia/Kolkata",
                        "resolvedZone": "Asia/Calcutta",
                        "localDateTime": "2026-07-01T17:30:00.000",
                        "utcOffset": "+05:30",
                        "utcOffsetSeconds": 19800,
                        "zonedDateTime": "2026-07-01T17:30:00.000+05:30[Asia/Calcutta]"
                      },
                      {
                        "requestedZone": "Pacific/Auckland",
                        "resolvedZone": "Pacific/Auckland",
                        "localDateTime": "2026-07-02T00:00:00.000",
                        "utcOffset": "+12:00",
                        "utcOffsetSeconds": 43200,
                        "zonedDateTime": "2026-07-02T00:00:00.000+12:00[Pacific/Auckland]"
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "599c99deae8e260cb7e847cb1c355c412a58e9ff9edb355b6e066d7edef1705a",
                    "outputSha256": "2badc1e493bca94a8e8ab528c7a960ccc6cde822748d705f5bab5e405bb5f6c8",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/blob-decode": {
      "post": {
        "operationId": "x402_blob_decode",
        "summary": "Bounded compressed blob batch decoding",
        "description": "Decode 1–10 inline canonical Base64 gzip or zlib-wrapped deflate blobs to strict UTF-8 or Base64 bytes. Streaming aggregate input/output and per-item expansion caps. No Brotli, archive extraction, remote fetch, nested decoding or content interpretation.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/blob-decode.md"
        },
        "x-agent-discovery": {
          "intents": [
            "batch decode compressed blobs",
            "decompress gzip Base64 payload",
            "decode zlib deflate data",
            "bounded binary payload decompression"
          ],
          "whenToUse": [
            "Decode 1–10 supplied gzip or zlib-wrapped deflate blobs under a combined 32 KiB compressed / 64 KiB decoded budget, retaining strict text or binary bytes."
          ],
          "whenNotToUse": [
            "Brotli, raw deflate, ZIP/TAR archives, multiple gzip members, compression autodetection, external files or URLs, dictionaries, nested decoding, JSON parsing, code execution or large/high-ratio payloads."
          ],
          "capabilities": [
            "gzip decompression",
            "zlib deflate decompression",
            "canonical Base64 input",
            "strict UTF-8",
            "binary Base64 output",
            "batch decoding",
            "streaming output limits"
          ],
          "related": [
            "base64-convert",
            "content-digest",
            "json-repair"
          ],
          "limits": {
            "items": 10,
            "compressedBytes": 32768,
            "decodedBytes": 65536,
            "expansionRatio": 100,
            "inputChunkBytes": 256,
            "base64CodeUnitsPerItem": 43692,
            "outputBytes": 410000,
            "outputLimitScope": "aggregate across all batch items",
            "ratioLimitScope": "per item, decompressed bytes / total compressed bytes",
            "codecs": "gzip single member; zlib-wrapped deflate"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "DUPLICATE_ID",
            "NONCANONICAL_BASE64",
            "COMPRESSED_INPUT_LIMIT",
            "DECOMPRESSION_LIMIT",
            "INVALID_COMPRESSED_DATA",
            "INVALID_UTF8",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "string",
                    "const": "bounded-compressed-blob-batch-v1"
                  },
                  "items": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80,
                          "pattern": "^[A-Za-z0-9_-]+$"
                        },
                        "compression": {
                          "type": "string",
                          "enum": [
                            "gzip",
                            "deflate"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "minLength": 4,
                          "maxLength": 43692,
                          "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
                        },
                        "outputEncoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "compression",
                        "data",
                        "outputEncoding"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "profile",
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile": "bounded-compressed-blob-batch-v1",
                "items": [
                  {
                    "id": "message",
                    "compression": "gzip",
                    "data": "H4sIAAAAAAAAA8tIzcnJBwCGphA2BQAAAA==",
                    "outputEncoding": "utf8"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "blob-decode",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "bounded-compressed-blob-batch-v1"
                        },
                        "itemCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10
                        },
                        "totalCompressedBytes": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 32768
                        },
                        "totalDecodedBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 65536
                        },
                        "results": {
                          "minItems": 1,
                          "maxItems": 10,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "compression": {
                                "type": "string",
                                "enum": [
                                  "gzip",
                                  "deflate"
                                ]
                              },
                              "outputEncoding": {
                                "type": "string",
                                "enum": [
                                  "utf8",
                                  "base64"
                                ]
                              },
                              "compressedBytes": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 32768
                              },
                              "decodedBytes": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 65536
                              },
                              "expansionRatio": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 100
                              },
                              "decodedSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "data": {
                                "type": "string",
                                "maxLength": 87384
                              }
                            },
                            "required": [
                              "id",
                              "compression",
                              "outputEncoding",
                              "compressedBytes",
                              "decodedBytes",
                              "expansionRatio",
                              "decodedSha256",
                              "data"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "itemCount",
                        "totalCompressedBytes",
                        "totalDecodedBytes",
                        "results"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "blob-decode",
                  "version": "0.29.0",
                  "result": {
                    "profile": "bounded-compressed-blob-batch-v1",
                    "itemCount": 1,
                    "totalCompressedBytes": 25,
                    "totalDecodedBytes": 5,
                    "results": [
                      {
                        "id": "message",
                        "compression": "gzip",
                        "outputEncoding": "utf8",
                        "compressedBytes": 25,
                        "decodedBytes": 5,
                        "expansionRatio": 0.2,
                        "decodedSha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
                        "data": "hello"
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "a928ecf9b5fc113ec31a216e63971729f4ccace245c3095f1b95ded834981ec0",
                    "outputSha256": "637ff52e4d85f31c2d1d2b262dedd5f1bbfc28107236408b6209e158077ca55d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/dockerfile-audit": {
      "post": {
        "operationId": "x402_dockerfile_audit",
        "summary": "Bounded Dockerfile static audit",
        "description": "Inspect one supplied Dockerfile for 14 bounded static risk and hygiene signals with line ranges, rule IDs, redacted evidence and remediation. Understands continuations, escape directives, literal stage inheritance and JSON forms. No execution, image/CVE scan, fetch, variable evaluation or safe-image verdict; heredocs, ONBUILD and custom frontends are rejected.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/dockerfile-audit.md"
        },
        "x-agent-discovery": {
          "intents": [
            "audit supplied Dockerfile text",
            "Dockerfile static risk analysis",
            "lint Dockerfile build hygiene",
            "review Dockerfile base image pinning and runtime user"
          ],
          "whenToUse": [
            "Get bounded static observations about one supplied Dockerfile's literal image references, stage/user configuration, COPY/ADD sources, secret-like names and instruction forms."
          ],
          "whenNotToUse": [
            "Build or execute a Dockerfile, inspect an image or registry, find CVEs, certify security, analyze Compose/Kubernetes, evaluate shell commands or ARG values, or parse heredocs, ONBUILD or custom syntax frontends."
          ],
          "capabilities": [
            "supplied Dockerfile",
            "line-numbered findings",
            "static audit",
            "multi-stage build",
            "base image digest pinning",
            "root USER signal",
            "secret-like variable names",
            "redacted evidence",
            "COPY ADD review"
          ],
          "limits": {
            "inputCodeUnits": 65536,
            "dockerfileUtf8Bytes": 65536,
            "physicalLines": 2048,
            "instructions": 512,
            "instructionCodeUnits": 8192,
            "stages": 64,
            "findings": 128,
            "outputBytes": 180000,
            "rules": 14,
            "variableEvaluation": "none",
            "sourceEcho": "none",
            "externalRequests": 0,
            "shellAnalysis": "none"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_DOCKERFILE",
            "UNSUPPORTED_DOCKERFILE_SYNTAX",
            "DOCKERFILE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "string",
                    "const": "bounded-dockerfile-static-v1"
                  },
                  "dockerfile": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 65536
                  }
                },
                "required": [
                  "profile",
                  "dockerfile"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile": "bounded-dockerfile-static-v1",
                "dockerfile": "FROM node:22 AS build\nWORKDIR /app\nCOPY . .\nRUN npm ci\nFROM node:22-slim\nCOPY --from=build /app /app\nUSER 1000:1000\nENTRYPOINT [\"node\", \"/app/server.js\"]\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "dockerfile-audit",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "bounded-dockerfile-static-v1"
                        },
                        "analysis": {
                          "type": "string",
                          "const": "bounded-static-observations"
                        },
                        "inputBytes": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 65536
                        },
                        "physicalLines": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 2048
                        },
                        "instructionCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 512
                        },
                        "finalStageIndex": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 63
                        },
                        "stages": {
                          "minItems": 1,
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 63
                              },
                              "fromLine": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              "endLine": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              "baseKind": {
                                "type": "string",
                                "enum": [
                                  "external-image",
                                  "prior-stage",
                                  "scratch",
                                  "variable-dependent"
                                ]
                              },
                              "digestPinned": {
                                "type": [
                                  "boolean",
                                  "null"
                                ]
                              },
                              "runtimeUser": {
                                "type": "string",
                                "enum": [
                                  "explicit-root",
                                  "explicit-nonroot",
                                  "named-user-unknown",
                                  "base-unknown",
                                  "variable-dependent"
                                ]
                              },
                              "userSourceLine": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "index",
                              "fromLine",
                              "endLine",
                              "baseKind",
                              "digestPinned",
                              "runtimeUser",
                              "userSourceLine"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "rulesEvaluated": {
                          "minItems": 14,
                          "maxItems": 14,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "DF001",
                              "DF002",
                              "DF003",
                              "DF004",
                              "DF005",
                              "DF006",
                              "DF007",
                              "DF008",
                              "DF009",
                              "DF010",
                              "DF011",
                              "DF012",
                              "DF013",
                              "DF014"
                            ]
                          }
                        },
                        "findings": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "ruleId": {
                                "type": "string",
                                "enum": [
                                  "DF001",
                                  "DF002",
                                  "DF003",
                                  "DF004",
                                  "DF005",
                                  "DF006",
                                  "DF007",
                                  "DF008",
                                  "DF009",
                                  "DF010",
                                  "DF011",
                                  "DF012",
                                  "DF013",
                                  "DF014"
                                ]
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "info",
                                  "warning"
                                ]
                              },
                              "category": {
                                "type": "string",
                                "enum": [
                                  "reproducibility",
                                  "security-configuration",
                                  "build-hygiene",
                                  "portability"
                                ]
                              },
                              "confidence": {
                                "type": "string",
                                "enum": [
                                  "syntactic",
                                  "heuristic"
                                ]
                              },
                              "line": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              "endLine": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              "stageIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "evidence": {
                                "type": "string",
                                "maxLength": 180
                              },
                              "message": {
                                "type": "string",
                                "maxLength": 300
                              },
                              "remediation": {
                                "type": "string",
                                "maxLength": 400
                              }
                            },
                            "required": [
                              "ruleId",
                              "severity",
                              "category",
                              "confidence",
                              "line",
                              "endLine",
                              "stageIndex",
                              "evidence",
                              "message",
                              "remediation"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "summary": {
                          "type": "object",
                          "properties": {
                            "totalFindings": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "returnedFindings": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 128
                            },
                            "bySeverity": {
                              "type": "object",
                              "properties": {
                                "info": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "warning": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "info",
                                "warning"
                              ],
                              "additionalProperties": false
                            },
                            "truncated": {
                              "type": "boolean"
                            },
                            "variableDependentInstructions": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "totalFindings",
                            "returnedFindings",
                            "bySeverity",
                            "truncated",
                            "variableDependentInstructions"
                          ],
                          "additionalProperties": false
                        },
                        "limitations": {
                          "minItems": 1,
                          "maxItems": 12,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 350
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "analysis",
                        "inputBytes",
                        "physicalLines",
                        "instructionCount",
                        "finalStageIndex",
                        "stages",
                        "rulesEvaluated",
                        "findings",
                        "summary",
                        "limitations"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "dockerfile-audit",
                  "version": "0.29.0",
                  "result": {
                    "profile": "bounded-dockerfile-static-v1",
                    "analysis": "bounded-static-observations",
                    "inputBytes": 154,
                    "physicalLines": 8,
                    "instructionCount": 8,
                    "finalStageIndex": 1,
                    "stages": [
                      {
                        "index": 0,
                        "fromLine": 1,
                        "endLine": 4,
                        "baseKind": "external-image",
                        "digestPinned": false,
                        "runtimeUser": "base-unknown",
                        "userSourceLine": null
                      },
                      {
                        "index": 1,
                        "fromLine": 5,
                        "endLine": 8,
                        "baseKind": "external-image",
                        "digestPinned": false,
                        "runtimeUser": "explicit-nonroot",
                        "userSourceLine": 7
                      }
                    ],
                    "rulesEvaluated": [
                      "DF001",
                      "DF002",
                      "DF003",
                      "DF004",
                      "DF005",
                      "DF006",
                      "DF007",
                      "DF008",
                      "DF009",
                      "DF010",
                      "DF011",
                      "DF012",
                      "DF013",
                      "DF014"
                    ],
                    "findings": [
                      {
                        "ruleId": "DF002",
                        "severity": "info",
                        "category": "reproducibility",
                        "confidence": "syntactic",
                        "line": 1,
                        "endLine": 1,
                        "stageIndex": 0,
                        "evidence": "FROM external image: explicit tag, no sha256 digest",
                        "message": "External base image has a tag but no digest pin.",
                        "remediation": "Consider pinning a verified digest for reproducibility; arrange updates so pinning does not indefinitely prevent security fixes."
                      },
                      {
                        "ruleId": "DF007",
                        "severity": "info",
                        "category": "build-hygiene",
                        "confidence": "syntactic",
                        "line": 3,
                        "endLine": 3,
                        "stageIndex": 0,
                        "evidence": "COPY includes a literal whole-context source; ignore rules not inspected",
                        "message": "A local COPY or ADD source includes the context root or a whole-context wildcard.",
                        "remediation": "Review .dockerignore and prefer the required paths. Context contents and ignore rules were not supplied, so accidental inclusion is not established."
                      },
                      {
                        "ruleId": "DF002",
                        "severity": "info",
                        "category": "reproducibility",
                        "confidence": "syntactic",
                        "line": 5,
                        "endLine": 5,
                        "stageIndex": 1,
                        "evidence": "FROM external image: explicit tag, no sha256 digest",
                        "message": "External base image has a tag but no digest pin.",
                        "remediation": "Consider pinning a verified digest for reproducibility; arrange updates so pinning does not indefinitely prevent security fixes."
                      }
                    ],
                    "summary": {
                      "totalFindings": 3,
                      "returnedFindings": 3,
                      "bySeverity": {
                        "info": 3,
                        "warning": 0
                      },
                      "truncated": false,
                      "variableDependentInstructions": 0
                    },
                    "limitations": [
                      "Static observations only: no build, command execution, filesystem access, network requests, registry lookup, vulnerability scan or safety verdict.",
                      "Base-image metadata, runtime overrides, build arguments, named contexts, .dockerignore and source files are not available. Variable expressions are not evaluated, including ARG defaults.",
                      "Shell programs and package-install commands are opaque. No shell correctness, package pinning or script security analysis is performed.",
                      "Recognized instructions without a listed rule are retained for structure only. This is not a complete Docker parser, compiler or build-success check.",
                      "Heredocs, ONBUILD, custom/labs frontends, unknown instructions/flags, ambiguous terminal escapes and malformed supported forms are rejected rather than partially interpreted.",
                      "Findings are potential issues to review. Secret checks use names only; values, source snippets, image references and URLs are not echoed. A report with no findings does not establish safety.",
                      "The final stage is the last textual FROM; --target selection is not an input. Rules inspect all textual stages, including stages a build might skip. Docker #check suppressions do not suppress this profile's rules."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "da6f61385220259b52108217ce4cdf1b3ba1cca6ab6e6fc3a888dfc8b17095dc",
                    "outputSha256": "590de60e78b37fc2620732486c55052fcc81de4436e975f6161100084cbcab00",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/records-join": {
      "post": {
        "operationId": "x402_records_join",
        "summary": "Typed guarded record join",
        "description": "WHEN TO USE: Produce actual inner, left or full joined row pairs from two supplied tables using typed scalar JSON Pointer keys. Enforces declared cardinality over both complete inputs before matching; duplicate null-containing keys count for uniqueness even when nullKeys=never-match. Preserves provenance and order, rejects fanout overruns without partial output. No coercion, fuzzy matching, database access or semantic relationship verification.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-join.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Join two tables while retaining source rows and indexes",
            "Enrich records with a typed lookup and guard duplicate keys",
            "Build inner left or full joins with explicit many-to-many fanout"
          ],
          "whenToUse": [
            "Join two tables while retaining source rows and indexes",
            "Enrich records with a typed lookup and guard duplicate keys",
            "Build inner left or full joins with explicit many-to-many fanout"
          ],
          "whenNotToUse": [
            "Fuzzy or semantic entity matching, coercing scalar keys, or proving a business relationship",
            "Silently combining colliding columns or truncating a join to fit a cap",
            "Fetching data, executing caller code, contacting agents, transmitting a payload, or changing remote state",
            "Verifying semantic truth, source authenticity, identity, permissions, or business relationships"
          ],
          "capabilities": [
            "Typed composite scalar keys distinguish number, string, boolean and null",
            "Checks declared uniqueness over entire inputs including unmatched and null-containing keys",
            "Preflights all output row cardinality; stable left/right provenance pairs",
            "Networkless deterministic transforms; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "maxRowsPerSide": 500,
            "maxKeyPairs": 5,
            "maxPointerSegments": 20,
            "maxOutputRows": 2000,
            "nullUniqueness": "null-containing keys count toward uniqueness"
          },
          "related": [
            "record-relations",
            "records-project",
            "records-filter"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_POINTER",
            "MISSING_KEY",
            "INVALID_KEY",
            "CARDINALITY_VIOLATION",
            "OUTPUT_ROW_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "left": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1records-join/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "right": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1records-join/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "keys": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "left": {
                          "type": "string",
                          "maxLength": 2048,
                          "description": "RFC 6901 string pointer, at most 20 segments. Empty pointer selects the row object, which is not a scalar join key. No URI fragments or reserved property segments."
                        },
                        "right": {
                          "type": "string",
                          "maxLength": 2048,
                          "description": "RFC 6901 string pointer, at most 20 segments. Empty pointer selects the row object, which is not a scalar join key. No URI fragments or reserved property segments."
                        }
                      },
                      "required": [
                        "left",
                        "right"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "inner",
                      "left",
                      "full"
                    ]
                  },
                  "cardinality": {
                    "default": "many-to-one",
                    "type": "string",
                    "enum": [
                      "one-to-one",
                      "many-to-one",
                      "many-to-many"
                    ]
                  },
                  "nullKeys": {
                    "default": "never-match",
                    "type": "string",
                    "enum": [
                      "never-match",
                      "match"
                    ]
                  },
                  "maxOutputRows": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 2000
                  }
                },
                "required": [
                  "left",
                  "right",
                  "keys",
                  "kind",
                  "maxOutputRows"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1records-join/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1records-join/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "left": [
                  {
                    "sku": "A",
                    "qty": 2
                  },
                  {
                    "sku": "B",
                    "qty": 1
                  }
                ],
                "right": [
                  {
                    "code": "A",
                    "label": "Adapters"
                  }
                ],
                "keys": [
                  {
                    "left": "/sku",
                    "right": "/code"
                  }
                ],
                "kind": "left",
                "cardinality": "many-to-one",
                "nullKeys": "never-match",
                "maxOutputRows": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-join",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "typed-records-join-v1"
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "inner",
                            "left",
                            "full"
                          ]
                        },
                        "cardinality": {
                          "type": "string",
                          "enum": [
                            "one-to-one",
                            "many-to-one",
                            "many-to-many"
                          ]
                        },
                        "nullKeys": {
                          "type": "string",
                          "enum": [
                            "never-match",
                            "match"
                          ]
                        },
                        "rows": {
                          "maxItems": 2000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "leftIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 499
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "rightIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 499
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "left": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/paths/~1v1~1x402~1records-join/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "right": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/paths/~1v1~1x402~1records-join/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "leftIndex",
                              "rightIndex",
                              "left",
                              "right"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "outputRows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matchedLeftRows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "unmatchedLeftRows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matchedRightRows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "unmatchedRightRows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "kind",
                        "cardinality",
                        "nullKeys",
                        "rows",
                        "outputRows",
                        "matchedLeftRows",
                        "unmatchedLeftRows",
                        "matchedRightRows",
                        "unmatchedRightRows",
                        "externalRequests",
                        "semanticValidityVerified"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1records-join/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1records-join/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-join",
                  "version": "0.29.0",
                  "result": {
                    "profile": "typed-records-join-v1",
                    "kind": "left",
                    "cardinality": "many-to-one",
                    "nullKeys": "never-match",
                    "rows": [
                      {
                        "leftIndex": 0,
                        "rightIndex": 0,
                        "left": {
                          "sku": "A",
                          "qty": 2
                        },
                        "right": {
                          "code": "A",
                          "label": "Adapters"
                        }
                      },
                      {
                        "leftIndex": 1,
                        "rightIndex": null,
                        "left": {
                          "sku": "B",
                          "qty": 1
                        },
                        "right": null
                      }
                    ],
                    "outputRows": 2,
                    "matchedLeftRows": 1,
                    "unmatchedLeftRows": 1,
                    "matchedRightRows": 1,
                    "unmatchedRightRows": 0,
                    "externalRequests": 0,
                    "semanticValidityVerified": false
                  },
                  "provenance": {
                    "inputSha256": "2a6e27489652f9ea391dd0820684e8a9690cbe8d4028b086ee11cdd12dc51022",
                    "outputSha256": "68a134752f33121788d4152199e9678ecea72b4e7e92ca50d19e0eb40fdbc57b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/localized-number-parse": {
      "post": {
        "operationId": "x402_localized_number_parse",
        "summary": "Explicit localized number parser",
        "description": "WHEN TO USE: Convert supplied localized numeric spellings into exact ASCII decimal strings using a declared digit alphabet, symbols and primary/secondary grouping. Validates the entire spelling with per-item rejections; preserves fractional digit count and negative-zero evidence. No locale inference, floating-point numeric conversion, exponent/currency parsing or full CLDR claim. Maximum 200 items and 128 Unicode code points each.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/localized-number-parse.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Parse localized decimal strings with an explicit digit and separator profile",
            "Convert grouped Arabic-Indic or comma-decimal numbers without floating-point loss",
            "Reject partially parsed numbers and retain negative zero and fractional precision evidence"
          ],
          "whenToUse": [
            "Parse localized decimal strings with an explicit digit and separator profile",
            "Convert grouped Arabic-Indic or comma-decimal numbers without floating-point loss",
            "Reject partially parsed numbers and retain negative zero and fractional precision evidence"
          ],
          "whenNotToUse": [
            "Inferring a locale, full CLDR/ICU conformance, currency or percentage conversion, exponent notation or accounting parentheses",
            "Normalizing Unicode or repairing malformed numeric spellings",
            "Fetching data, executing caller code, contacting agents, transmitting a payload, or changing remote state",
            "Verifying semantic truth, source authenticity, identity, permissions, or business relationships"
          ],
          "capabilities": [
            "Exact ASCII decimal output, without JSON floating-point conversion",
            "Optional grouping with strict primary/secondary group widths and whole-string matching",
            "Item-level syntax rejection; invalid or ambiguous profiles reject the entire batch",
            "Networkless deterministic transforms; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "maxItems": 200,
            "maxTextCodePoints": 128,
            "digitAlphabetCodePoints": 10,
            "maxGroupWidth": 9,
            "trim": "none or leading/trailing U+0020 only",
            "numericOutput": "canonical ASCII decimal string"
          },
          "related": [
            "numeric-rounding-check",
            "csv-parse",
            "integer-apportion"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_PROFILE",
            "DUPLICATE_ID"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "object",
                    "properties": {
                      "decimal": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2,
                        "description": "Exactly one Unicode scalar value; distinct from every digit and other enabled syntax symbol."
                      },
                      "group": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 2,
                            "description": "Exactly one Unicode scalar value; distinct from every digit and other enabled syntax symbol."
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "digits": {
                        "type": "string",
                        "minLength": 10,
                        "maxLength": 20,
                        "description": "Exactly ten distinct Unicode scalar values, in digit-value order zero through nine."
                      },
                      "primaryGroup": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 9
                      },
                      "secondaryGroup": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 9
                      },
                      "minus": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 2,
                            "description": "Exactly one Unicode scalar value; distinct from every digit and other enabled syntax symbol."
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "plus": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 2,
                            "description": "Exactly one Unicode scalar value; distinct from every digit and other enabled syntax symbol."
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "trim": {
                        "type": "string",
                        "enum": [
                          "none",
                          "ascii-space"
                        ]
                      }
                    },
                    "required": [
                      "decimal",
                      "digits",
                      "primaryGroup",
                      "secondaryGroup",
                      "minus",
                      "plus",
                      "trim"
                    ],
                    "additionalProperties": false
                  },
                  "items": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 256,
                          "description": "At most 128 Unicode scalar values (up to 256 UTF-16 code units); complete numeric spelling required."
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "profile",
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile": {
                  "decimal": ",",
                  "group": ".",
                  "digits": "0123456789",
                  "primaryGroup": 3,
                  "secondaryGroup": 3,
                  "minus": "-",
                  "plus": "+",
                  "trim": "none"
                },
                "items": [
                  {
                    "id": "amount",
                    "text": "1.234,50"
                  },
                  {
                    "id": "bad",
                    "text": "12.34,50"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "localized-number-parse",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "explicit-localized-decimal-v1"
                        },
                        "items": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "status": {
                                    "type": "string",
                                    "const": "parsed"
                                  },
                                  "decimal": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 129,
                                    "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d*[1-9])?$"
                                  },
                                  "fractionDigits": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 127
                                  },
                                  "negativeZero": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "id",
                                  "status",
                                  "decimal",
                                  "fractionDigits",
                                  "negativeZero"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "status": {
                                    "type": "string",
                                    "const": "rejected"
                                  },
                                  "code": {
                                    "type": "string",
                                    "enum": [
                                      "EMPTY_NUMBER",
                                      "INVALID_DECIMAL",
                                      "INVALID_GROUPING",
                                      "INVALID_DIGIT"
                                    ]
                                  }
                                },
                                "required": [
                                  "id",
                                  "status",
                                  "code"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        },
                        "parsedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "rejectedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "items",
                        "parsedCount",
                        "rejectedCount",
                        "externalRequests",
                        "semanticValidityVerified"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "localized-number-parse",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-localized-decimal-v1",
                    "items": [
                      {
                        "id": "amount",
                        "status": "parsed",
                        "decimal": "1234.5",
                        "fractionDigits": 2,
                        "negativeZero": false
                      },
                      {
                        "id": "bad",
                        "status": "rejected",
                        "code": "INVALID_GROUPING"
                      }
                    ],
                    "parsedCount": 1,
                    "rejectedCount": 1,
                    "externalRequests": 0,
                    "semanticValidityVerified": false
                  },
                  "provenance": {
                    "inputSha256": "fed04dea67f41b2b280d65a04628f220b1990342b4b23286c7385e670866cf8a",
                    "outputSha256": "33f7fc6af42ba5fea58d25f6e6642910702fb70b6d7f6dbcbf15122d3ffd535a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-batch-encode": {
      "post": {
        "operationId": "x402_json_batch_encode",
        "summary": "Exact UTF-8 JSON batch encoder",
        "description": "WHEN TO USE: Produce contiguous, greedy, byte-bounded JSON-array or LF-terminated NDJSON wire bodies from supplied JSON values. Counts actual UTF-8 bodies including framing and escaping; optional SHA-256 hashes those unchanged bytes. Uses recursive key sorting plus JSON.stringify, not RFC 8785; rejects malformed Unicode and oversized records without partial batches. No transmission, endpoint-limit verification, compression or token accounting.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-batch-encode.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Encode exact byte-limited JSON array or NDJSON request payload batches",
            "Pack JSON records into contiguous UTF-8-sized bodies without splitting records",
            "Measure escaped JSON framing and hash unchanged batch wire bytes"
          ],
          "whenToUse": [
            "Encode exact byte-limited JSON array or NDJSON request payload batches",
            "Pack JSON records into contiguous UTF-8-sized bodies without splitting records",
            "Measure escaped JSON framing and hash unchanged batch wire bytes"
          ],
          "whenNotToUse": [
            "Sending requests, validating target endpoint schemas or actual server limits, sizing headers, HTTP framing, compression or tokenization",
            "Arbitrary-precision JSON numbers or RFC 8785 cryptographic canonicalization",
            "Fetching data, executing caller code, contacting agents, transmitting a payload, or changing remote state",
            "Verifying semantic truth, source authenticity, identity, permissions, or business relationships"
          ],
          "capabilities": [
            "Actual body UTF-8 byte counts, not the result wrapper representation",
            "Greedy contiguous record-preserving batches with hard item and byte caps",
            "Recursive sorted-key JSON.stringify profile; array order retained and final LF required for NDJSON",
            "Single oversized record rejects all output; optional SHA-256 hashes exact body bytes",
            "Networkless deterministic transforms; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "maxRecords": 500,
            "maxUtf8Bytes": 100000,
            "maxItemsPerBatch": 500,
            "maxBatches": 500,
            "serialization": "recursive sorted-key JSON.stringify; integer-index keys first numerically",
            "ndjsonFinalLf": "always on nonempty batches"
          },
          "related": [
            "json-canonicalize",
            "ndjson-inspect",
            "message-batch-plan"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "RECORD_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "$ref": "#/paths/~1v1~1x402~1json-batch-encode/post/requestBody/content/application~1json/schema/$defs/__schema0"
                    }
                  },
                  "framing": {
                    "type": "string",
                    "enum": [
                      "json-array",
                      "ndjson-lf"
                    ]
                  },
                  "maxUtf8Bytes": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100000
                  },
                  "maxItemsPerBatch": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 500
                  },
                  "includeSha256": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "records",
                  "framing",
                  "maxUtf8Bytes",
                  "maxItemsPerBatch"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-batch-encode/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-batch-encode/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "x": "é"
                  },
                  {
                    "x": "a"
                  },
                  {
                    "x": "😀"
                  }
                ],
                "framing": "json-array",
                "maxUtf8Bytes": 23,
                "maxItemsPerBatch": 100,
                "includeSha256": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-batch-encode",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "sorted-json-utf8-batches-v1"
                        },
                        "framing": {
                          "type": "string",
                          "enum": [
                            "json-array",
                            "ndjson-lf"
                          ]
                        },
                        "batches": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "itemIndexes": {
                                "minItems": 1,
                                "maxItems": 500,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 499
                                }
                              },
                              "bodyText": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "utf8Bytes": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100000
                              },
                              "sha256": {
                                "type": "string",
                                "pattern": "^[0-9a-f]{64}$"
                              }
                            },
                            "required": [
                              "itemIndexes",
                              "bodyText",
                              "utf8Bytes"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "itemCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "batchCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "totalUtf8Bytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "framing",
                        "batches",
                        "itemCount",
                        "batchCount",
                        "totalUtf8Bytes",
                        "externalRequests",
                        "semanticValidityVerified"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-batch-encode",
                  "version": "0.29.0",
                  "result": {
                    "profile": "sorted-json-utf8-batches-v1",
                    "framing": "json-array",
                    "batches": [
                      {
                        "itemIndexes": [
                          0,
                          1
                        ],
                        "bodyText": "[{\"x\":\"é\"},{\"x\":\"a\"}]",
                        "utf8Bytes": 22,
                        "sha256": "2806c29934df94f04cf761490e60e34550c4b905e5bce434c874377c74d5bd1f"
                      },
                      {
                        "itemIndexes": [
                          2
                        ],
                        "bodyText": "[{\"x\":\"😀\"}]",
                        "utf8Bytes": 14,
                        "sha256": "62ec360b21da91f071c8ce7a2866d45c424c8f162eecb1dc504d8b32de7a0cc7"
                      }
                    ],
                    "itemCount": 3,
                    "batchCount": 2,
                    "totalUtf8Bytes": 36,
                    "externalRequests": 0,
                    "semanticValidityVerified": false
                  },
                  "provenance": {
                    "inputSha256": "d9cc3efaf7a499898a72fd490b169cb52507707b5cd1a1651b4dd9d21a06139d",
                    "outputSha256": "aef8b58f28ceab34c9424ba2b58eeecb3b82d2d92d1319868c84336f3aceaedd",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/integer-apportion": {
      "post": {
        "operationId": "x402_integer_apportion",
        "summary": "Apportion exact integer units",
        "description": "Allocate a declared integer total among exact nonnegative decimal weights using floors and largest remainders. Conserves units with exact quota evidence and ID tie breaks; no minima, caps, fairness certification, payments or monotonicity guarantee.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/integer-apportion.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Divide a fixed total of indivisible units among weighted categories",
            "Produce integer weighted allocations whose sum equals the declared total"
          ],
          "whenToUse": [
            "Divide a fixed total of indivisible units among weighted categories",
            "Produce integer weighted allocations whose sum equals the declared total"
          ],
          "whenNotToUse": [
            "Fairness certification, eligibility decisions about people, payments, or resource reservations",
            "Monotonic allocation as total changes, recipient minimums or maximums",
            "Live execution, network lookups, payments, reservation, or inferring factual correctness of supplied data"
          ],
          "capabilities": [
            "largest-remainder-v1 profile; exact BigInt decimal scaling and reduced quota/remainder fractions",
            "Largest fractional remainder first; ties and output order use exact UTF-16 ID ordering independent of input order",
            "Networkless supplied-input computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "recipients": 128,
            "totalIntegerDigits": 24,
            "weightIntegerDigits": 24,
            "weightFractionDigits": 18
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "ZERO_WEIGHT_TOTAL"
          ],
          "related": [
            "rubric-score-aggregate",
            "numeric-rounding-check"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "totalUnits": {
                    "type": "string",
                    "maxLength": 24,
                    "pattern": "^(?:0|[1-9]\\d{0,23})$",
                    "description": "Canonical nonnegative integer string, at most 24 digits"
                  },
                  "recipients": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "weight": {
                          "type": "string",
                          "maxLength": 43,
                          "pattern": "^(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Nonnegative exact decimal string; 24 integer and 18 fraction digits; at least one weight positive"
                        }
                      },
                      "required": [
                        "id",
                        "weight"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "totalUnits",
                  "recipients"
                ],
                "additionalProperties": false
              },
              "example": {
                "totalUnits": "7",
                "recipients": [
                  {
                    "id": "a",
                    "weight": "5"
                  },
                  {
                    "id": "b",
                    "weight": "3"
                  },
                  {
                    "id": "c",
                    "weight": "2"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "integer-apportion",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "largest-remainder-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "totalUnits": {
                          "type": "string",
                          "maxLength": 100,
                          "pattern": "^(?:0|[1-9]\\d*)$"
                        },
                        "allocatedTotal": {
                          "type": "string",
                          "maxLength": 100,
                          "pattern": "^(?:0|[1-9]\\d*)$"
                        },
                        "remainderUnits": {
                          "type": "string",
                          "const": "0"
                        },
                        "allocations": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "units": {
                                "type": "string",
                                "maxLength": 100,
                                "pattern": "^(?:0|[1-9]\\d*)$"
                              },
                              "floor": {
                                "type": "string",
                                "maxLength": 100,
                                "pattern": "^(?:0|[1-9]\\d*)$"
                              },
                              "extraUnit": {
                                "type": "boolean"
                              },
                              "quota": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 100,
                                    "pattern": "^(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 100,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "remainder": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 100,
                                    "pattern": "^(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 100,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "id",
                              "units",
                              "floor",
                              "extraUnit",
                              "quota",
                              "remainder"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "totalUnits",
                        "allocatedTotal",
                        "remainderUnits",
                        "allocations"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "integer-apportion",
                  "version": "0.29.0",
                  "result": {
                    "profile": "largest-remainder-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "totalUnits": "7",
                    "allocatedTotal": "7",
                    "remainderUnits": "0",
                    "allocations": [
                      {
                        "id": "a",
                        "units": "4",
                        "floor": "3",
                        "extraUnit": true,
                        "quota": {
                          "numerator": "7",
                          "denominator": "2"
                        },
                        "remainder": {
                          "numerator": "1",
                          "denominator": "2"
                        }
                      },
                      {
                        "id": "b",
                        "units": "2",
                        "floor": "2",
                        "extraUnit": false,
                        "quota": {
                          "numerator": "21",
                          "denominator": "10"
                        },
                        "remainder": {
                          "numerator": "1",
                          "denominator": "10"
                        }
                      },
                      {
                        "id": "c",
                        "units": "1",
                        "floor": "1",
                        "extraUnit": false,
                        "quota": {
                          "numerator": "7",
                          "denominator": "5"
                        },
                        "remainder": {
                          "numerator": "2",
                          "denominator": "5"
                        }
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "9ddf2d69428662c833132d77986f8ca47250684ac4bca2b93c84eddcabf5afc5",
                    "outputSha256": "e58555a1109461b1bc3bfc820c78fbcb5225f855ca34d39e5d9c465cce4f1aaa",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/business-calendar-shift": {
      "post": {
        "operationId": "x402_business_calendar_shift",
        "summary": "Shift explicit business dates",
        "description": "Shift date-only Gregorian values by working days under supplied weekly closures and explicit closed dates. Roll an initially closed anchor explicitly, then count open dates strictly after or before it. No holiday lookup, clock, timezone or legal deadline verification.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/business-calendar-shift.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Add or subtract business days on an explicit supplied closure calendar",
            "Roll a closed starting date before a date-only working-day offset"
          ],
          "whenToUse": [
            "Add or subtract business days on an explicit supplied closure calendar",
            "Roll a closed starting date before a date-only working-day offset"
          ],
          "whenNotToUse": [
            "National holiday discovery, bank settlement or legal deadline advice",
            "Working-hour arithmetic, timezone conversion, recurring event scheduling or real organization calendar verification",
            "Live execution, network lookups, payments, reservation, or inferring factual correctness of supplied data"
          ],
          "capabilities": [
            "explicit-business-calendar-v1; Gregorian years 1900–2199 and Monday=1 through Sunday=7",
            "First roll anchor; offset zero returns anchor; calendarDays is signed result minus original start",
            "Atomic call: any invalid date, closed error anchor, range or traversal failure withholds all results",
            "Skipped evidence is in traversal order and includes rolled closed anchors; repeated visits are counted; first 100 retained per item",
            "Networkless supplied-input computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "items": 128,
            "closedDates": 500,
            "workingDays": "-366..366",
            "minYear": 1900,
            "maxYear": 2199,
            "itemDateVisits": 10000,
            "totalDateVisits": 100000,
            "skippedEvidencePerItem": 100
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "INVALID_DATE",
            "INVALID_CALENDAR",
            "CLOSED_START",
            "DATE_RANGE_EXHAUSTED",
            "TRAVERSAL_LIMIT"
          ],
          "related": [
            "timestamp-convert",
            "duration-convert",
            "timezone-convert"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "calendar": {
                    "type": "object",
                    "properties": {
                      "closedWeekdays": {
                        "maxItems": 7,
                        "type": "array",
                        "items": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 7
                        },
                        "description": "Monday=1 through Sunday=7; duplicate weekdays rejected; at least one weekday must stay open"
                      },
                      "closedDates": {
                        "maxItems": 500,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 10,
                          "maxLength": 10,
                          "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                          "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                        },
                        "description": "Explicit closures only; duplicates are collapsed"
                      }
                    },
                    "required": [
                      "closedWeekdays",
                      "closedDates"
                    ],
                    "additionalProperties": false
                  },
                  "items": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "start": {
                          "type": "string",
                          "minLength": 10,
                          "maxLength": 10,
                          "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                          "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                        },
                        "workingDays": {
                          "type": "integer",
                          "minimum": -366,
                          "maximum": 366
                        },
                        "roll": {
                          "type": "string",
                          "enum": [
                            "error",
                            "following",
                            "preceding"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "start",
                        "workingDays",
                        "roll"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "calendar",
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "calendar": {
                  "closedWeekdays": [
                    6,
                    7
                  ],
                  "closedDates": [
                    "2026-10-05"
                  ]
                },
                "items": [
                  {
                    "id": "review",
                    "start": "2026-10-02",
                    "workingDays": 1,
                    "roll": "error"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "business-calendar-shift",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "explicit-business-calendar-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "calendarVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "visitedDates": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "items": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "start": {
                                "type": "string",
                                "minLength": 10,
                                "maxLength": 10,
                                "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                                "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                              },
                              "anchor": {
                                "type": "string",
                                "minLength": 10,
                                "maxLength": 10,
                                "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                                "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                              },
                              "date": {
                                "type": "string",
                                "minLength": 10,
                                "maxLength": 10,
                                "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                                "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                              },
                              "workingDays": {
                                "type": "integer",
                                "minimum": -366,
                                "maximum": 366
                              },
                              "calendarDays": {
                                "type": "integer",
                                "minimum": -109572,
                                "maximum": 109572
                              },
                              "rolledCalendarDays": {
                                "type": "integer",
                                "minimum": -109572,
                                "maximum": 109572
                              },
                              "visitedDates": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "skippedDates": {
                                "maxItems": 100,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 10,
                                  "maxLength": 10,
                                  "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                                  "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                                }
                              },
                              "skippedDateCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "omittedSkippedDates": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "skippedDatesTruncated": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "id",
                              "start",
                              "anchor",
                              "date",
                              "workingDays",
                              "calendarDays",
                              "rolledCalendarDays",
                              "visitedDates",
                              "skippedDates",
                              "skippedDateCount",
                              "omittedSkippedDates",
                              "skippedDatesTruncated"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "calendarVerified",
                        "visitedDates",
                        "items"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "business-calendar-shift",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-business-calendar-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "calendarVerified": false,
                    "visitedDates": 5,
                    "items": [
                      {
                        "id": "review",
                        "start": "2026-10-02",
                        "anchor": "2026-10-02",
                        "date": "2026-10-06",
                        "workingDays": 1,
                        "calendarDays": 4,
                        "rolledCalendarDays": 0,
                        "visitedDates": 5,
                        "skippedDates": [
                          "2026-10-03",
                          "2026-10-04",
                          "2026-10-05"
                        ],
                        "skippedDateCount": 3,
                        "omittedSkippedDates": 0,
                        "skippedDatesTruncated": false
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "b59e754638f0b033f77a1cf5d45d473561821694b365b24d7bfdfc536f9f9ac8",
                    "outputSha256": "52a3d3006c0778b8d94a4ca5ccc726ae86341723fc1c029d21eab5f40975d43e",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/localization-bundle-build": {
      "post": {
        "operationId": "x402_localization_bundle_build",
        "summary": "Build literal localization bundles",
        "description": "Produce an atomic source-ordered localization bundle after exact key coverage and repeated {{name}} placeholder checks. Explicit source fallback provenance; malformed double braces or mismatches block the bundle. No translation, language verification, rendering or escaping.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/localization-bundle-build.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Build a source-ordered target localization dictionary with explicit fallback provenance",
            "Check literal translated placeholder names and repeated counts before releasing a bundle"
          ],
          "whenToUse": [
            "Build a source-ordered target localization dictionary with explicit fallback provenance",
            "Check literal translated placeholder names and repeated counts before releasing a bundle"
          ],
          "whenNotToUse": [
            "Generate or evaluate translations, detect language or verify semantic quality",
            "ICU/MessageFormat plural rules, printf, HTML/Markdown interpretation, sanitization or locale fallback chains",
            "Live execution, network lookups, payments, reservation, or inferring factual correctness of supplied data"
          ],
          "capabilities": [
            "double-brace-literal-v1 requires ASCII [A-Za-z_][A-Za-z0-9_.-]{0,63} names; reserved __proto__/constructor/prototype names block; single braces are literal",
            "Placeholder multisets must match including repeats; order may differ; texts remain unchanged",
            "Duplicate/unknown/missing keys, malformed double braces or mismatch yield blocked with bundle:null; no partially validated bundle",
            "Missing mode is required: error or source-fallback; output entries follow source input order",
            "Networkless supplied-input computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "sourceEntries": 1000,
            "targetEntries": 1000,
            "entryTextCodeUnits": 10000,
            "totalTextCodeUnits": 60000,
            "placeholderNameCodeUnits": 64
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "TEXT_LIMIT"
          ],
          "related": [
            "template-render",
            "records-project"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "format": {
                    "type": "string",
                    "const": "double-brace-literal-v1"
                  },
                  "missing": {
                    "type": "string",
                    "enum": [
                      "error",
                      "source-fallback"
                    ]
                  },
                  "source": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 10000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "target": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 10000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "format",
                  "missing",
                  "source",
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "format": "double-brace-literal-v1",
                "missing": "source-fallback",
                "source": [
                  {
                    "id": "welcome",
                    "text": "Hello, {{name}}!"
                  },
                  {
                    "id": "save",
                    "text": "Save"
                  }
                ],
                "target": [
                  {
                    "id": "welcome",
                    "text": "Hola, {{name}}!"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "localization-bundle-build",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "double-brace-literal-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "translationVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "escaped": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "ready",
                            "ready-with-fallbacks",
                            "blocked"
                          ]
                        },
                        "bundle": {
                          "anyOf": [
                            {
                              "maxItems": 1000,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "text": {
                                    "type": "string",
                                    "maxLength": 10000
                                  },
                                  "origin": {
                                    "type": "string",
                                    "enum": [
                                      "target",
                                      "source-fallback"
                                    ]
                                  },
                                  "placeholders": {
                                    "maxItems": 2000,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "name": {
                                          "type": "string",
                                          "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,63}$"
                                        },
                                        "count": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "name",
                                        "count"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "text",
                                  "origin",
                                  "placeholders"
                                ],
                                "additionalProperties": false
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "sourceCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "targetCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "translatedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "fallbackCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "fallbackIds": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "placeholder": {
                                "type": "string"
                              },
                              "sourceCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "targetCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "code",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "translationVerified",
                        "escaped",
                        "status",
                        "bundle",
                        "sourceCount",
                        "targetCount",
                        "translatedCount",
                        "fallbackCount",
                        "fallbackIds",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "localization-bundle-build",
                  "version": "0.29.0",
                  "result": {
                    "profile": "double-brace-literal-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "translationVerified": false,
                    "escaped": false,
                    "status": "ready-with-fallbacks",
                    "bundle": [
                      {
                        "id": "welcome",
                        "text": "Hola, {{name}}!",
                        "origin": "target",
                        "placeholders": [
                          {
                            "name": "name",
                            "count": 1
                          }
                        ]
                      },
                      {
                        "id": "save",
                        "text": "Save",
                        "origin": "source-fallback",
                        "placeholders": []
                      }
                    ],
                    "sourceCount": 2,
                    "targetCount": 1,
                    "translatedCount": 1,
                    "fallbackCount": 1,
                    "fallbackIds": [
                      "save"
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "635f16fce938905c7e4bdb383eeb07bf6a272f963164242617e3913e38ddab38",
                    "outputSha256": "9bfff22dfcf38e181c31122c7df3812a6f33b8d9a49c897ae0a17d172899b15b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/workflow-resource-plan": {
      "post": {
        "operationId": "x402_workflow_resource_plan",
        "summary": "Renewable Resource Workflow Planner",
        "description": "Build a deterministic capacity-feasible candidate task schedule with dependencies, release times and renewable resource demands; no optimality or live availability guarantee.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/workflow-resource-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Schedule dependent tasks against supplied concurrent worker or renewable resource capacities",
            "Return earliest-insertion candidate start and end times when unlimited-worker DAG timing is insufficient"
          ],
          "whenToUse": [
            "Schedule dependent tasks against supplied concurrent worker or renewable resource capacities",
            "Return earliest-insertion candidate start and end times when unlimited-worker DAG timing is insufficient"
          ],
          "whenNotToUse": [
            "Optimal makespan, execution, resource reservations, observed worker availability or runtime prediction",
            "Token-bucket dispatch quotas or retry timing",
            "Proof that no schedule can fit a caller horizon"
          ],
          "capabilities": [
            "Nonpreemptive serial schedule generation; ready-task order is priority descending then exact UTF-16 ID ascending",
            "Earliest feasible integer insertion; half-open execution intervals; prior placements never move",
            "Complete resource-usage evidence and complete candidate even when the reporting horizon is exceeded",
            "All input durations, capacities and availability are assumptions; no external requests or execution"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "tasks": 64,
            "resources": 8,
            "dependencyEdges": 256,
            "resourceUnits": 1000000000,
            "duration": 1000000000,
            "release": 1000000000000,
            "scheduleTime": 1064000000000,
            "usageSegments": 128,
            "buckets": 8,
            "jobs": 200,
            "tokenUnits": 1000000000,
            "refillPeriodMs": 1000000000,
            "horizonMs": 1000000000000
          },
          "related": [
            "workflow-dag-analyze",
            "quota-dispatch-plan"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "DUPLICATE_DEPENDENCY",
            "MISSING_DEPENDENCY",
            "UNKNOWN_RESOURCE",
            "DEMAND_EXCEEDS_CAPACITY",
            "DEPENDENCY_CYCLE",
            "TIME_LIMIT",
            "INTERNAL_PLANNING_ERROR"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "resources": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "additionalProperties": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 1000000000
                    }
                  },
                  "tasks": {
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "duration": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000000
                        },
                        "release": {
                          "default": 0,
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000000
                        },
                        "priority": {
                          "default": 0,
                          "type": "integer",
                          "minimum": -1000000000,
                          "maximum": 1000000000
                        },
                        "requires": {
                          "default": {},
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "additionalProperties": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 1000000000
                          }
                        },
                        "dependsOn": {
                          "default": [],
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        }
                      },
                      "required": [
                        "id",
                        "duration"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "horizon": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1064000000000
                  }
                },
                "required": [
                  "resources",
                  "tasks"
                ],
                "additionalProperties": false
              },
              "example": {
                "resources": {
                  "cpu": 2,
                  "browser": 1
                },
                "tasks": [
                  {
                    "id": "a",
                    "duration": 5,
                    "requires": {
                      "cpu": 1,
                      "browser": 1
                    },
                    "dependsOn": []
                  },
                  {
                    "id": "b",
                    "duration": 3,
                    "requires": {
                      "cpu": 1,
                      "browser": 1
                    },
                    "dependsOn": []
                  },
                  {
                    "id": "c",
                    "duration": 4,
                    "requires": {
                      "cpu": 2
                    },
                    "dependsOn": [
                      "a"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "workflow-resource-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "availabilityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "scheduled",
                            "horizon-exceeded"
                          ]
                        },
                        "tasks": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1064000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1064000000000
                              }
                            },
                            "required": [
                              "id",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "selectionOrder": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "makespan": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1064000000000
                        },
                        "horizon": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1064000000000
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "withinHorizon": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "optimalityGuaranteed": {
                          "type": "boolean",
                          "const": false
                        },
                        "resourceUsage": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1064000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1064000000000
                              },
                              "usage": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "additionalProperties": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 1000000000
                                }
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "usage"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "advisoryOnly",
                        "externalRequests",
                        "execution",
                        "availabilityVerified",
                        "status",
                        "tasks",
                        "selectionOrder",
                        "makespan",
                        "horizon",
                        "withinHorizon",
                        "optimalityGuaranteed",
                        "resourceUsage"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "workflow-resource-plan",
                  "version": "0.29.0",
                  "result": {
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "execution": false,
                    "availabilityVerified": false,
                    "status": "scheduled",
                    "tasks": [
                      {
                        "id": "a",
                        "start": 0,
                        "end": 5
                      },
                      {
                        "id": "b",
                        "start": 5,
                        "end": 8
                      },
                      {
                        "id": "c",
                        "start": 8,
                        "end": 12
                      }
                    ],
                    "selectionOrder": [
                      "a",
                      "b",
                      "c"
                    ],
                    "makespan": 12,
                    "horizon": null,
                    "withinHorizon": null,
                    "optimalityGuaranteed": false,
                    "resourceUsage": [
                      {
                        "start": 0,
                        "end": 8,
                        "usage": {
                          "browser": 1,
                          "cpu": 1
                        }
                      },
                      {
                        "start": 8,
                        "end": 12,
                        "usage": {
                          "browser": 0,
                          "cpu": 2
                        }
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "d1150812127c26832befbe825634dd56b8e2ccfb0db8042878f7c054d8dd2361",
                    "outputSha256": "29c03bb47adc67b5c6c79c353333f2d3a6cbc8fed59059f5721ecc702014135c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/quota-dispatch-plan": {
      "post": {
        "operationId": "x402_quota_dispatch_plan",
        "summary": "FIFO Token Bucket Dispatch Planner",
        "description": "Plan FIFO not-before times from supplied continuous-refill token buckets, with exact rational balance evidence and an explicitly partial horizon prefix; no requests are sent.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/quota-dispatch-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Plan FIFO API job dispatch against supplied token bucket capacity and refill assumptions",
            "Return exact not-before millisecond times and rational before/after quota balances"
          ],
          "whenToUse": [
            "Plan FIFO API job dispatch against supplied token bucket capacity and refill assumptions",
            "Return exact not-before millisecond times and rational before/after quota balances"
          ],
          "whenNotToUse": [
            "Live quota discovery, provider conformance, request sending, retry permission or guaranteed server acceptance",
            "Persistent quota reservations or synchronization across workers",
            "Renewable resources held for execution durations or optimal job reordering"
          ],
          "capabilities": [
            "Strict token buckets; continuous capped refill; exact BigInt scaled balances and ceiling waits",
            "Supplied FIFO order, head-of-line waiting, simultaneous integer-millisecond dispatch and atomic costs",
            "Horizon-limited prefix is explicitly partial; zero-refill exhaustion withholds every dispatch",
            "All balances are hypothetical; final state is at the last returned dispatch, or time zero for an empty prefix"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "tasks": 64,
            "resources": 8,
            "dependencyEdges": 256,
            "resourceUnits": 1000000000,
            "duration": 1000000000,
            "release": 1000000000000,
            "scheduleTime": 1064000000000,
            "usageSegments": 128,
            "buckets": 8,
            "jobs": 200,
            "tokenUnits": 1000000000,
            "refillPeriodMs": 1000000000,
            "horizonMs": 1000000000000
          },
          "related": [
            "retry-schedule-plan",
            "workflow-resource-plan"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "INVALID_INITIAL_BALANCE",
            "UNKNOWN_BUCKET",
            "IMPOSSIBLE_COST"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "horizonMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000000000
                  },
                  "buckets": {
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "capacity": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000000
                        },
                        "initialTokens": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000
                        },
                        "refillTokens": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000
                        },
                        "refillPeriodMs": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000000
                        }
                      },
                      "required": [
                        "id",
                        "capacity",
                        "initialTokens",
                        "refillTokens",
                        "refillPeriodMs"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "jobs": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "releaseMs": {
                          "default": 0,
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000000
                        },
                        "costs": {
                          "default": {},
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "additionalProperties": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 1000000000
                          }
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "horizonMs",
                  "buckets",
                  "jobs"
                ],
                "additionalProperties": false
              },
              "example": {
                "horizonMs": 5000,
                "buckets": [
                  {
                    "id": "api",
                    "capacity": 4,
                    "initialTokens": 4,
                    "refillTokens": 1,
                    "refillPeriodMs": 1000
                  }
                ],
                "jobs": [
                  {
                    "id": "a",
                    "releaseMs": 0,
                    "costs": {
                      "api": 3
                    }
                  },
                  {
                    "id": "b",
                    "releaseMs": 0,
                    "costs": {
                      "api": 3
                    }
                  },
                  {
                    "id": "c",
                    "releaseMs": 0,
                    "costs": {
                      "api": 1
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "quota-dispatch-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "availabilityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "planned",
                            "partial",
                            "blocked"
                          ]
                        },
                        "horizonMs": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000000
                        },
                        "jobs": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "notBeforeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "buckets": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    "before": {
                                      "type": "object",
                                      "properties": {
                                        "numerator": {
                                          "type": "string",
                                          "maxLength": 19,
                                          "pattern": "^(?:0|[1-9]\\d*)$"
                                        },
                                        "denominator": {
                                          "type": "string",
                                          "maxLength": 10,
                                          "pattern": "^[1-9]\\d*$"
                                        }
                                      },
                                      "required": [
                                        "numerator",
                                        "denominator"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "after": {
                                      "type": "object",
                                      "properties": {
                                        "numerator": {
                                          "type": "string",
                                          "maxLength": 19,
                                          "pattern": "^(?:0|[1-9]\\d*)$"
                                        },
                                        "denominator": {
                                          "type": "string",
                                          "maxLength": 10,
                                          "pattern": "^[1-9]\\d*$"
                                        }
                                      },
                                      "required": [
                                        "numerator",
                                        "denominator"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "before",
                                    "after"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "id",
                              "notBeforeMs",
                              "buckets"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "unplannedIds": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "nextNotBeforeMs": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 19,
                              "pattern": "^(?:0|[1-9]\\d*)$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "blockedJobId": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "blockedReason": {
                          "anyOf": [
                            {
                              "type": "string",
                              "const": "zero-refill-exhausted"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "finalState": {
                          "type": "object",
                          "properties": {
                            "atMs": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1000000000000
                            },
                            "buckets": {
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "tokens": {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 19,
                                        "pattern": "^(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 10,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "required": [
                                  "id",
                                  "tokens"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "atMs",
                            "buckets"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "advisoryOnly",
                        "externalRequests",
                        "execution",
                        "availabilityVerified",
                        "status",
                        "horizonMs",
                        "jobs",
                        "unplannedIds",
                        "nextNotBeforeMs",
                        "blockedJobId",
                        "blockedReason",
                        "finalState"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "quota-dispatch-plan",
                  "version": "0.29.0",
                  "result": {
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "execution": false,
                    "availabilityVerified": false,
                    "status": "planned",
                    "horizonMs": 5000,
                    "jobs": [
                      {
                        "id": "a",
                        "notBeforeMs": 0,
                        "buckets": [
                          {
                            "id": "api",
                            "before": {
                              "numerator": "4",
                              "denominator": "1"
                            },
                            "after": {
                              "numerator": "1",
                              "denominator": "1"
                            }
                          }
                        ]
                      },
                      {
                        "id": "b",
                        "notBeforeMs": 2000,
                        "buckets": [
                          {
                            "id": "api",
                            "before": {
                              "numerator": "3",
                              "denominator": "1"
                            },
                            "after": {
                              "numerator": "0",
                              "denominator": "1"
                            }
                          }
                        ]
                      },
                      {
                        "id": "c",
                        "notBeforeMs": 3000,
                        "buckets": [
                          {
                            "id": "api",
                            "before": {
                              "numerator": "1",
                              "denominator": "1"
                            },
                            "after": {
                              "numerator": "0",
                              "denominator": "1"
                            }
                          }
                        ]
                      }
                    ],
                    "unplannedIds": [],
                    "nextNotBeforeMs": null,
                    "blockedJobId": null,
                    "blockedReason": null,
                    "finalState": {
                      "atMs": 3000,
                      "buckets": [
                        {
                          "id": "api",
                          "tokens": {
                            "numerator": "0",
                            "denominator": "1"
                          }
                        }
                      ]
                    }
                  },
                  "provenance": {
                    "inputSha256": "38b1cb2bd534f97f7e12eaaedc096de9e2f396892167f446d070db83ef6e6a9a",
                    "outputSha256": "e31439c612a93e1f88c98ad92992588a1e636b8ec4122bd8f3245d61086b264b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/jsonc-values-rewrite": {
      "post": {
        "operationId": "x402_jsonc_values_rewrite",
        "summary": "Guarded JSONC scalar rewriter",
        "description": "WHEN TO USE: Rewrite existing supplied JSONC scalar values by guarded RFC 6901 pointers while preserving every source character outside the selected value tokens. Strict object-root JSON plus comments and explicit trailing-comma mode; duplicate decoded keys, malformed untouched regions and unsafe integer-valued numbers fail atomically. No general JSON5, structural edits, configuration security checks or filesystem writes.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/jsonc-values-rewrite.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Change guarded scalar configuration values while preserving JSONC comments and untouched formatting",
            "Resolve scalar JSON pointers to source spans before an exact configuration edit"
          ],
          "whenToUse": [
            "Change guarded scalar configuration values while preserving JSONC comments and untouched formatting",
            "Resolve scalar JSON pointers to source spans before an exact configuration edit"
          ],
          "whenNotToUse": [
            "JSON5 syntax, root arrays, duplicate object names, unsafe integers, scalar type changes, insertions, deletions or structure changes",
            "General formatting, schema validation, semantic config safety, arbitrary-precision decimal preservation or file writes",
            "Uploading, executing artifacts, contacting agents or registries, publishing, or changing remote state",
            "Verifying semantic truth, source authenticity, permissions, target API acceptance or signatures"
          ],
          "capabilities": [
            "Profile jsonc-guarded-scalars-v1; entire source parses without recovery",
            "Original-document guards, unique paths and atomic same-type scalar edits",
            "Untouched source characters and scalar spellings preserved; appliedPaths ordered by source position",
            "Result reparsed and compared to an independently constructed intended document; numeric equality identifies negative zero with zero",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "jsonc-guarded-scalars-v1",
            "sourceBytes": 60000,
            "syntaxNodes": 5000,
            "parsedDepth": 20,
            "rewrites": 100,
            "pointerUnits": 512,
            "resultTextBytes": 100000,
            "syntaxNodeCounting": "all JSON values plus member-name tokens; root depth zero",
            "lineCommentEnd": "CR, LF or EOF"
          },
          "related": [
            "text-edits-apply",
            "json-patch",
            "json-schema-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "SOURCE_LIMIT",
            "JSONC_SYNTAX",
            "JSONC_ROOT",
            "JSONC_COMPLEXITY",
            "UNSAFE_NUMBER",
            "DUPLICATE_KEY",
            "INVALID_POINTER",
            "DUPLICATE_PATH",
            "MISSING_PATH",
            "NONSCALAR_TARGET",
            "EXPECTED_MISMATCH",
            "SCALAR_TYPE_CHANGE",
            "RESULT_TEXT_LIMIT",
            "REWRITE_VERIFICATION"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 60000
                  },
                  "allowTrailingComma": {
                    "type": "boolean"
                  },
                  "rewrites": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "maxLength": 512
                        },
                        "expected": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 60000
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "value": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 60000
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "path",
                        "expected",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "text",
                  "allowTrailingComma",
                  "rewrites"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "{\n  // retry budget\n  \"retries\": 2,\n  \"label\": \"prod\",\n}\n",
                "allowTrailingComma": true,
                "rewrites": [
                  {
                    "path": "/retries",
                    "expected": 2,
                    "value": 4
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "jsonc-values-rewrite",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "document": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/paths/~1v1~1x402~1jsonc-values-rewrite/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                          }
                        },
                        "appliedPaths": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 512
                          }
                        }
                      },
                      "required": [
                        "text",
                        "document",
                        "appliedPaths"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1jsonc-values-rewrite/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1jsonc-values-rewrite/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "jsonc-values-rewrite",
                  "version": "0.29.0",
                  "result": {
                    "text": "{\n  // retry budget\n  \"retries\": 4,\n  \"label\": \"prod\",\n}\n",
                    "document": {
                      "retries": 4,
                      "label": "prod"
                    },
                    "appliedPaths": [
                      "/retries"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "8da8ead2632413e3bb0515b55b688399495f46637557e2f0c254ab46ccef7406",
                    "outputSha256": "23597cbeb1977c4dc132cadb81871bbbd8a51f41e141e50511aee04eae4c690d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/multipart-form-encode": {
      "post": {
        "operationId": "x402_multipart_form_encode",
        "summary": "Exact multipart form body encoder",
        "description": "WHEN TO USE: Construct exact inert multipart/form-data bytes from ordered supplied text or binary file parts, preserving repeated field names. Caller supplies a collision-checked boundary; explicit utf8 or canonical padded Base64 output and decoded wire byte count. Strict ASCII names prevent header injection; no upload, custom headers, nested multipart, automatic field flattening or API acceptance claim.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/multipart-form-encode.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Encode ordered multipart form-data upload bodies with binary files and repeated field names",
            "Measure exact multipart request bytes with deterministic collision-checked boundaries"
          ],
          "whenToUse": [
            "Encode ordered multipart form-data upload bodies with binary files and repeated field names",
            "Measure exact multipart request bytes with deterministic collision-checked boundaries"
          ],
          "whenNotToUse": [
            "Performing HTTP requests or uploads, headers beyond Content-Disposition and Content-Type, nested multipart or endpoint compatibility",
            "Non-ASCII field names or filenames, path filenames, filename*, or implicit charset guessing",
            "Uploading, executing artifacts, contacting agents or registries, publishing, or changing remote state",
            "Verifying semantic truth, source authenticity, permissions, target API acceptance or signatures"
          ],
          "capabilities": [
            "Profile rfc7578-bounded-body-v1; exact CRLF framing and one final closing delimiter",
            "Boundary token rejected anywhere in decoded payload; linear byte scanning",
            "Filename-free fields require text/plain, valid UTF-8 and charset=UTF-8; file media types retain caller casing",
            "Canonical padded standard Base64 with zero padding bits; utf8 output requires valid full-body UTF-8",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "rfc7578-bounded-body-v1",
            "parts": 32,
            "nameBytes": 64,
            "filenameBytes": 128,
            "mediaTypeBytes": 127,
            "boundaryBytes": 60,
            "payloadBytes": 60000,
            "wireBytes": 100000,
            "mediaTypeProfile": "RFC6838 restricted ASCII type/subtype; no parameters"
          },
          "related": [
            "json-batch-encode",
            "base64-convert",
            "content-digest"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "NESTED_MULTIPART",
            "TEXT_MEDIA_TYPE",
            "INVALID_UTF8",
            "BOUNDARY_COLLISION",
            "WIRE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "boundary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 60,
                    "pattern": "^[A-Za-z0-9_-]+$"
                  },
                  "outputEncoding": {
                    "type": "string",
                    "enum": [
                      "utf8",
                      "base64"
                    ]
                  },
                  "parts": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64,
                          "pattern": "^[\\x20-\\x21\\x23-\\x2e\\x30-\\x5b\\x5d-\\x7e]+$"
                        },
                        "filename": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "pattern": "^[\\x20-\\x21\\x23-\\x2e\\x30-\\x5b\\x5d-\\x7e]+$"
                        },
                        "mediaType": {
                          "type": "string",
                          "minLength": 3,
                          "maxLength": 127,
                          "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*\\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*$"
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 80000
                        }
                      },
                      "required": [
                        "name",
                        "mediaType",
                        "encoding",
                        "data"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "boundary",
                  "outputEncoding",
                  "parts"
                ],
                "additionalProperties": false
              },
              "example": {
                "boundary": "b42",
                "outputEncoding": "utf8",
                "parts": [
                  {
                    "name": "file",
                    "filename": "notes.txt",
                    "mediaType": "text/plain",
                    "encoding": "utf8",
                    "data": "abc"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "multipart-form-encode",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "contentType": {
                          "type": "string",
                          "minLength": 31,
                          "maxLength": 100
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "body": {
                          "type": "string",
                          "maxLength": 133336
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100000
                        },
                        "partCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 32
                        }
                      },
                      "required": [
                        "contentType",
                        "encoding",
                        "body",
                        "byteLength",
                        "partCount"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "multipart-form-encode",
                  "version": "0.29.0",
                  "result": {
                    "contentType": "multipart/form-data; boundary=b42",
                    "encoding": "utf8",
                    "body": "--b42\r\nContent-Disposition: form-data; name=\"file\"; filename=\"notes.txt\"\r\nContent-Type: text/plain\r\n\r\nabc\r\n--b42--\r\n",
                    "byteLength": 116,
                    "partCount": 1
                  },
                  "provenance": {
                    "inputSha256": "e22407bb1d5d4451adb5676aab25633a52b61787a22e1f399b608e6643546d39",
                    "outputSha256": "dfa67a8c7d10639911e78caf05010359fbc718ebbbc7a4983d3f907c154ed739",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/oci-artifact-compose": {
      "post": {
        "operationId": "x402_oci_artifact_compose",
        "summary": "Inline OCI artifact manifest composer",
        "description": "WHEN TO USE: Build a supplied-input OCI 1.1.1 artifact manifest with SHA-256 digests, exact decoded sizes and inline Base64 bytes for every ordered file layer. Caller declares artifactType and media types; fixed empty JSON config and title-only annotations. No enclosing manifest digest, image build, filesystem layout, registry contact, upload, signature or authenticity guarantee.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/oci-artifact-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compose an OCI 1.1.1 artifact manifest from supplied binary or UTF-8 evidence files",
            "Compute content-addressed inline layer descriptors with exact file bytes and source mapping"
          ],
          "whenToUse": [
            "Compose an OCI 1.1.1 artifact manifest from supplied binary or UTF-8 evidence files",
            "Compute content-addressed inline layer descriptors with exact file bytes and source mapping"
          ],
          "whenNotToUse": [
            "OCI image building, registry access, pushing or pulling, tar/layout generation, signatures, provenance truth or publisher authenticity",
            "Enclosing manifest digest without exact serialized bytes, inferred timestamps, executable config, platform or subject",
            "Uploading, executing artifacts, contacting agents or registries, publishing, or changing remote state",
            "Verifying semantic truth, source authenticity, permissions, target API acceptance or signatures"
          ],
          "capabilities": [
            "Profile oci-1.1-inline-artifact-v1; OCI Image Specification 1.1.1 artifact guidance",
            "SHA-256 and size computed from exact decoded file bytes; standard data fields embed canonical Base64",
            "Fixed empty JSON config hashes exact UTF-8 {}; layer order and input-to-layer source map retained",
            "Only standard title annotations; duplicate names rejected, equal bytes under distinct names preserved",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "oci-1.1-inline-artifact-v1",
            "files": 32,
            "nameUnits": 128,
            "mediaTypeBytes": 127,
            "payloadBytes": 60000,
            "manifestBytes": 100000,
            "enclosingManifestDigest": "not returned",
            "mediaTypeProfile": "RFC6838 restricted ASCII type/subtype; no parameters"
          },
          "related": [
            "artifact-manifest-check",
            "content-digest",
            "json-canonicalize"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "INVALID_FILENAME",
            "DUPLICATE_FILENAME",
            "MANIFEST_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "artifactType": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 127,
                    "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*\\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*$"
                  },
                  "files": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "mediaType": {
                          "type": "string",
                          "minLength": 3,
                          "maxLength": 127,
                          "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*\\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*$"
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 80000
                        }
                      },
                      "required": [
                        "name",
                        "mediaType",
                        "encoding",
                        "data"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "artifactType",
                  "files"
                ],
                "additionalProperties": false
              },
              "example": {
                "artifactType": "application/vnd.example.release.v1",
                "files": [
                  {
                    "name": "notes.txt",
                    "mediaType": "text/plain",
                    "encoding": "utf8",
                    "data": "abc"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "oci-artifact-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "manifest": {
                          "type": "object",
                          "properties": {
                            "schemaVersion": {
                              "type": "number",
                              "const": 2
                            },
                            "mediaType": {
                              "type": "string",
                              "const": "application/vnd.oci.image.manifest.v1+json"
                            },
                            "artifactType": {
                              "type": "string",
                              "minLength": 3,
                              "maxLength": 127,
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*\\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*$"
                            },
                            "config": {
                              "type": "object",
                              "properties": {
                                "mediaType": {
                                  "type": "string",
                                  "const": "application/vnd.oci.empty.v1+json"
                                },
                                "digest": {
                                  "type": "string",
                                  "const": "sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a"
                                },
                                "size": {
                                  "type": "number",
                                  "const": 2
                                },
                                "data": {
                                  "type": "string",
                                  "const": "e30="
                                }
                              },
                              "required": [
                                "mediaType",
                                "digest",
                                "size",
                                "data"
                              ],
                              "additionalProperties": false
                            },
                            "layers": {
                              "minItems": 1,
                              "maxItems": 32,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "mediaType": {
                                    "type": "string",
                                    "minLength": 3,
                                    "maxLength": 127,
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*\\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*$"
                                  },
                                  "digest": {
                                    "type": "string",
                                    "pattern": "^sha256:[a-f0-9]{64}$"
                                  },
                                  "size": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 60000
                                  },
                                  "data": {
                                    "type": "string",
                                    "maxLength": 80000
                                  },
                                  "annotations": {
                                    "type": "object",
                                    "properties": {
                                      "org.opencontainers.image.title": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 128
                                      }
                                    },
                                    "required": [
                                      "org.opencontainers.image.title"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "required": [
                                  "mediaType",
                                  "digest",
                                  "size",
                                  "data",
                                  "annotations"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "schemaVersion",
                            "mediaType",
                            "artifactType",
                            "config",
                            "layers"
                          ],
                          "additionalProperties": false
                        },
                        "sourceMap": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 31
                              },
                              "layerIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 31
                              }
                            },
                            "required": [
                              "inputIndex",
                              "layerIndex"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "manifest",
                        "sourceMap"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "oci-artifact-compose",
                  "version": "0.29.0",
                  "result": {
                    "manifest": {
                      "schemaVersion": 2,
                      "mediaType": "application/vnd.oci.image.manifest.v1+json",
                      "artifactType": "application/vnd.example.release.v1",
                      "config": {
                        "mediaType": "application/vnd.oci.empty.v1+json",
                        "digest": "sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                        "size": 2,
                        "data": "e30="
                      },
                      "layers": [
                        {
                          "mediaType": "text/plain",
                          "digest": "sha256:ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad",
                          "size": 3,
                          "data": "YWJj",
                          "annotations": {
                            "org.opencontainers.image.title": "notes.txt"
                          }
                        }
                      ]
                    },
                    "sourceMap": [
                      {
                        "inputIndex": 0,
                        "layerIndex": 0
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "3bdff892ccc8769982df4a4d86508659e0fa7b5f8e1e7ec87dea660821348835",
                    "outputSha256": "36a3b667aea34e198c52ff1e2bd46e6ff7a8117d7f9e8b01ad250d831100b91f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/gitignore-path-select": {
      "post": {
        "operationId": "x402_gitignore_path_select",
        "summary": "Git-ignore Path Selection",
        "description": "Select supplied untracked file paths under a strict root-only ASCII Git-ignore subset with excluded-ancestor and final-rule evidence.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/gitignore-path-select.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Select supplied release files using root Git-ignore rules",
            "Explain excluded ancestors and negated file patterns"
          ],
          "whenToUse": [
            "Select supplied release files using root Git-ignore rules",
            "Explain excluded ancestors and negated file patterns"
          ],
          "whenNotToUse": [
            "Full Git-ignore syntax, bracket classes, escapes, nested ignore files, Git index/tracked state, symlinks, repository discovery or secret detection",
            "Fetching files, reading a repository, executing code or tests, contacting agents, publishing releases, or changing remote state"
          ],
          "capabilities": [
            "Declared profile: gitignore-root-ascii-v1",
            "Last matching root rule with explicit directory evaluation; excluded parents block child re-inclusion",
            "Literal segments, *, ?, supported positional **, root anchors, directory-only patterns and negation",
            "Preserves candidate input order; no matching rule gives null evidence; work-cap failure returns no selection",
            "Deterministic supplied-input-only operation; no network, filesystem, shell or current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "gitignore-root-ascii-v1",
            "paths": 500,
            "activeRules": 128,
            "pathBytes": 256,
            "ruleBytes": 256,
            "pathDepth": 16,
            "inferredNodes": 10000,
            "patternStateTransitions": 5000000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "UNSUPPORTED_PATTERN",
            "INVALID_PATH",
            "DUPLICATE_PATH",
            "PATH_COLLISION"
          ],
          "related": [
            "oci-artifact-compose",
            "multipart-form-encode",
            "artifact-manifest-check"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "paths": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 256
                    }
                  },
                  "ignoreText": {
                    "type": "string",
                    "maxLength": 100000
                  }
                },
                "required": [
                  "paths",
                  "ignoreText"
                ],
                "additionalProperties": false
              },
              "example": {
                "paths": [
                  "src/main.ts",
                  "dist/app.js",
                  "notes.txt",
                  "keep.log",
                  "debug.log"
                ],
                "ignoreText": "dist/\n*.log\n!keep.log\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "gitignore-path-select",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "selectedPaths": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "decisions": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "ignored": {
                                "type": "boolean"
                              },
                              "ruleLine": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "matchedPath": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "ancestorBlocked": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "path",
                              "ignored",
                              "ruleLine",
                              "matchedPath",
                              "ancestorBlocked"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "selectedPaths",
                        "decisions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "gitignore-path-select",
                  "version": "0.29.0",
                  "result": {
                    "selectedPaths": [
                      "src/main.ts",
                      "notes.txt",
                      "keep.log"
                    ],
                    "decisions": [
                      {
                        "path": "src/main.ts",
                        "ignored": false,
                        "ruleLine": null,
                        "matchedPath": null,
                        "ancestorBlocked": false
                      },
                      {
                        "path": "dist/app.js",
                        "ignored": true,
                        "ruleLine": 1,
                        "matchedPath": "dist",
                        "ancestorBlocked": true
                      },
                      {
                        "path": "notes.txt",
                        "ignored": false,
                        "ruleLine": null,
                        "matchedPath": null,
                        "ancestorBlocked": false
                      },
                      {
                        "path": "keep.log",
                        "ignored": false,
                        "ruleLine": 3,
                        "matchedPath": "keep.log",
                        "ancestorBlocked": false
                      },
                      {
                        "path": "debug.log",
                        "ignored": true,
                        "ruleLine": 2,
                        "matchedPath": "debug.log",
                        "ancestorBlocked": false
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "2e2220da3a7655d6e6fb606e0c4664a5081440814bfa8123f938d50a9284f1f6",
                    "outputSha256": "93ade9695e30afbb175491edc26b0ad710d2a6d3e05c60c28143be8ccd766f68",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/conventional-release-plan": {
      "post": {
        "operationId": "x402_conventional_release_plan",
        "summary": "Conventional Release Proposal",
        "description": "Propose a stable numeric version and escaped release notes from supplied commits under an explicit bounded Conventional Commit footer grammar and pre-1.0 policy.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/conventional-release-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Create release notes and a version proposal from supplied Conventional Commits",
            "Apply an explicit breaking-change policy before version 1.0"
          ],
          "whenToUse": [
            "Create release notes and a version proposal from supplied Conventional Commits",
            "Apply an explicit breaking-change policy before version 1.0"
          ],
          "whenNotToUse": [
            "Full SemVer/prerelease calculation, all Conventional Commit footer layouts, code-level breaking-change detection, commit-range discovery or revert cancellation",
            "Fetching files, reading a repository, executing code or tests, contacting agents, publishing releases, or changing remote state"
          ],
          "capabilities": [
            "Declared profile: conventional-release-explicit-policy-v1",
            "Case-insensitive type classification; ! and uppercase BREAKING CHANGE/BREAKING-CHANGE colon-space footers",
            "Strict final contiguous footer block with multiline nonblank values; ambiguous layouts fail with sourceIndex",
            "Fix means patch, feat means minor, breaking marker means declared major/pre-1.0 policy; highest effect wins",
            "Deterministic escaped Markdown; no dates, fabricated links, tags, commits, pushes or publishing",
            "Deterministic supplied-input-only operation; no network, filesystem, shell or current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "conventional-release-explicit-policy-v1",
            "commits": 200,
            "messageBytes": 8000,
            "aggregateMessageBytes": 60000,
            "physicalLines": 100,
            "footerEntries": 20,
            "idCharacters": 64,
            "typeScopeCharacters": 64,
            "versionComponent": 1000000000,
            "releaseOutputBytes": 150000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_VERSION",
            "INVALID_COMMIT",
            "INVALID_ID",
            "DUPLICATE_ID",
            "VERSION_OVERFLOW"
          ],
          "related": [
            "semver-evaluate",
            "jsonc-values-rewrite",
            "oci-artifact-compose"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "currentVersion": {
                    "type": "string",
                    "minLength": 5,
                    "maxLength": 32
                  },
                  "preOneBreaking": {
                    "type": "string",
                    "enum": [
                      "major",
                      "minor"
                    ]
                  },
                  "commits": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 8000
                        }
                      },
                      "required": [
                        "id",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "currentVersion",
                  "preOneBreaking",
                  "commits"
                ],
                "additionalProperties": false
              },
              "example": {
                "currentVersion": "1.2.3",
                "preOneBreaking": "major",
                "commits": [
                  {
                    "id": "c1",
                    "message": "feat(api): add CSV export"
                  },
                  {
                    "id": "c2",
                    "message": "fix: reset retry counter"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "conventional-release-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "releaseType": {
                          "type": "string",
                          "enum": [
                            "none",
                            "patch",
                            "minor",
                            "major"
                          ]
                        },
                        "nextVersion": {
                          "type": "string"
                        },
                        "entries": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "sourceIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "type": {
                                "type": "string"
                              },
                              "scope": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": "string"
                              },
                              "breaking": {
                                "type": "boolean"
                              },
                              "releaseEffect": {
                                "type": "string",
                                "enum": [
                                  "none",
                                  "patch",
                                  "minor",
                                  "major"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "sourceIndex",
                              "type",
                              "scope",
                              "description",
                              "breaking",
                              "releaseEffect"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "markdown": {
                          "type": "string"
                        },
                        "revertCancellationInferred": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "releaseType",
                        "nextVersion",
                        "entries",
                        "markdown",
                        "revertCancellationInferred"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "conventional-release-plan",
                  "version": "0.29.0",
                  "result": {
                    "releaseType": "minor",
                    "nextVersion": "1.3.0",
                    "entries": [
                      {
                        "id": "c1",
                        "sourceIndex": 0,
                        "type": "feat",
                        "scope": "api",
                        "description": "add CSV export",
                        "breaking": false,
                        "releaseEffect": "minor"
                      },
                      {
                        "id": "c2",
                        "sourceIndex": 1,
                        "type": "fix",
                        "scope": null,
                        "description": "reset retry counter",
                        "breaking": false,
                        "releaseEffect": "patch"
                      }
                    ],
                    "markdown": "## 1.3.0\n\n### Features\n- api: add CSV export (c1)\n\n### Fixes\n- reset retry counter (c2)\n",
                    "revertCancellationInferred": false
                  },
                  "provenance": {
                    "inputSha256": "4d87e41a7cedfd885e34012956bc8383d3363a7fd63c73524fa398a8e758d842",
                    "outputSha256": "a9fca5e8c388792b6f50bb334348886b90134c000d8d78935e802777946c7cbd",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/coverage-set-optimize": {
      "post": {
        "operationId": "x402_coverage_set_optimize",
        "summary": "Exact Declared Coverage Set",
        "description": "Find a proved minimum-cost subset covering up to 12 supplied requirement labels, then minimize cardinality and UTF-16 lexicographic IDs across at most 48 declared candidates.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/coverage-set-optimize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find minimum-cost declared checks covering all supplied requirement labels",
            "Choose an exact small weighted set cover with deterministic tie-breaking"
          ],
          "whenToUse": [
            "Find minimum-cost declared checks covering all supplied requirement labels",
            "Choose an exact small weighted set cover with deterministic tie-breaking"
          ],
          "whenNotToUse": [
            "Real test coverage, code impact, reliability, scheduling, inferred capabilities, personnel selection or high-impact decisions about people",
            "Large or approximate optimization, negative/zero costs, repeated candidates or extra constraints",
            "Fetching files, reading a repository, executing code or tests, contacting agents, publishing releases, or changing remote state"
          ],
          "capabilities": [
            "Declared profile: exact-declared-set-cover-v1",
            "Exact 0/1 bitmask dynamic programming; objective is cost, cardinality, then sorted UTF-16 candidate IDs",
            "Positive integer costs and bounded safe-integer sum; input-order-independent optimum",
            "Infeasible only when union coverage misses requirements; reports sorted missing labels; empty universe has zero-cost optimum",
            "Deterministic supplied-input-only operation; no network, filesystem, shell or current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "exact-declared-set-cover-v1",
            "requirements": 12,
            "candidates": 48,
            "costUnits": 1000000000,
            "totalCostUnits": 48000000000,
            "idUnits": 64,
            "candidateStateTransitions": 196608,
            "candidateRankComparisons": 9437184
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_REQUIREMENT",
            "DUPLICATE_ID",
            "DUPLICATE_COVERAGE",
            "UNKNOWN_REQUIREMENT"
          ],
          "related": [
            "context-budget-pack",
            "workflow-resource-plan",
            "workflow-dag-analyze"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "requirements": {
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    }
                  },
                  "candidates": {
                    "maxItems": 48,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "costUnits": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000000
                        },
                        "covers": {
                          "maxItems": 12,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          }
                        }
                      },
                      "required": [
                        "id",
                        "costUnits",
                        "covers"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "requirements",
                  "candidates"
                ],
                "additionalProperties": false
              },
              "example": {
                "requirements": [
                  "api",
                  "ui",
                  "docs"
                ],
                "candidates": [
                  {
                    "id": "smoke",
                    "costUnits": 4,
                    "covers": [
                      "api",
                      "ui"
                    ]
                  },
                  {
                    "id": "api-only",
                    "costUnits": 2,
                    "covers": [
                      "api"
                    ]
                  },
                  {
                    "id": "ui-only",
                    "costUnits": 3,
                    "covers": [
                      "ui"
                    ]
                  },
                  {
                    "id": "docs",
                    "costUnits": 1,
                    "covers": [
                      "docs"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "coverage-set-optimize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "enum": [
                            "optimal",
                            "infeasible"
                          ]
                        },
                        "selectedIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "totalCostUnits": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "coverage": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "requirement": {
                                "type": "string"
                              },
                              "selectedIds": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "required": [
                              "requirement",
                              "selectedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "uncovered": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "optimalWithinSuppliedModel": {
                          "type": "boolean"
                        },
                        "declaredCoverageOnly": {
                          "type": "boolean",
                          "const": true
                        }
                      },
                      "required": [
                        "status",
                        "selectedIds",
                        "totalCostUnits",
                        "coverage",
                        "uncovered",
                        "optimalWithinSuppliedModel",
                        "declaredCoverageOnly"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "coverage-set-optimize",
                  "version": "0.29.0",
                  "result": {
                    "status": "optimal",
                    "selectedIds": [
                      "docs",
                      "smoke"
                    ],
                    "totalCostUnits": 5,
                    "coverage": [
                      {
                        "requirement": "api",
                        "selectedIds": [
                          "smoke"
                        ]
                      },
                      {
                        "requirement": "docs",
                        "selectedIds": [
                          "docs"
                        ]
                      },
                      {
                        "requirement": "ui",
                        "selectedIds": [
                          "smoke"
                        ]
                      }
                    ],
                    "uncovered": [],
                    "optimalWithinSuppliedModel": true,
                    "declaredCoverageOnly": true
                  },
                  "provenance": {
                    "inputSha256": "11b8523cf1119acb556bbeee278dd3f32753bb6873f40eb4a979953872adf4e5",
                    "outputSha256": "31668e5cc928891467c30f72c5e2a0b379650880d0f37fca4ae0e2fda8d7e9a0",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/icalendar-compose": {
      "post": {
        "operationId": "x402_icalendar_compose",
        "summary": "Standalone iCalendar Artifact Composer",
        "description": "Create exact UTF-8 iCalendar text for up to 64 supplied standalone date-only or UTC events, with caller UIDs/stamps, escaped literal text and byte-bounded folding; no account changes or invitations.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/icalendar-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Create an ICS file from supplied standalone events",
            "Encode all-day or UTC calendar events with exact literal text and caller identifiers"
          ],
          "whenToUse": [
            "Create an ICS file from supplied standalone events",
            "Encode all-day or UTC calendar events with exact literal text and caller identifiers"
          ],
          "whenNotToUse": [
            "Calendar booking, finding free time, sending invitations or proving import success",
            "Recurrence, attendees, organizers, alarms, URLs, attachments, custom properties, time zones or floating local time",
            "Uploading artifacts, executing database statements, sending invitations, accessing calendars or changing remote state"
          ],
          "capabilities": [
            "Declared profile: rfc5545-standalone-events-v1",
            "Strict Gregorian years 1900–2199; explicit exclusive end, unique caller UID and UTC DTSTAMP",
            "TEXT escaping, fixed property order, final CRLF and Unicode-scalar-safe folding at 75 UTF-8 octets including continuation space",
            "Empty supplied optional text emitted; absent fields omitted; no generated identifiers or timestamps",
            "Deterministic supplied-input-only artifact; no network, filesystem, database, shell, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "events": 64,
            "summaryCodePoints": 1000,
            "locationCodePoints": 1000,
            "descriptionCodePoints": 8000,
            "textBytes": 60000,
            "wireBytes": 120000,
            "physicalLines": 4096,
            "uidBytes": 128,
            "years": "1900–2199",
            "profile": "rfc5545-standalone-events-v1"
          },
          "related": [
            "recurrence-dates-expand",
            "timezone-convert",
            "timestamp-convert"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_UID",
            "INVALID_CALENDAR_DATE",
            "INVALID_UTC_TIME",
            "INVALID_INTERVAL",
            "INVALID_TEXT_CONTROL",
            "TEXT_LIMIT",
            "CALENDAR_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "description": "Declared profile: rfc5545-standalone-events-v1",
                "type": "object",
                "properties": {
                  "events": {
                    "minItems": 1,
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "uid": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "pattern": "^[A-Za-z0-9._@+\\-]+$"
                        },
                        "dtstamp": {
                          "type": "string",
                          "maxLength": 20
                        },
                        "summary": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2000,
                          "description": "Literal text, at most 1,000 Unicode code points"
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 16000,
                          "description": "Literal text, at most 8,000 Unicode code points"
                        },
                        "location": {
                          "type": "string",
                          "maxLength": 2000,
                          "description": "Literal text, at most 1,000 Unicode code points"
                        },
                        "interval": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "date"
                                },
                                "start": {
                                  "type": "string",
                                  "maxLength": 10
                                },
                                "endExclusive": {
                                  "type": "string",
                                  "maxLength": 10
                                }
                              },
                              "required": [
                                "kind",
                                "start",
                                "endExclusive"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "utc"
                                },
                                "start": {
                                  "type": "string",
                                  "maxLength": 20
                                },
                                "endExclusive": {
                                  "type": "string",
                                  "maxLength": 20
                                }
                              },
                              "required": [
                                "kind",
                                "start",
                                "endExclusive"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        }
                      },
                      "required": [
                        "uid",
                        "dtstamp",
                        "summary",
                        "interval"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "events"
                ],
                "additionalProperties": false
              },
              "example": {
                "events": [
                  {
                    "uid": "review-1@example.invalid",
                    "dtstamp": "2026-10-05T00:00:00Z",
                    "summary": "Release, review",
                    "interval": {
                      "kind": "date",
                      "start": "2026-10-06",
                      "endExclusive": "2026-10-07"
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "icalendar-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "mediaType": {
                          "type": "string",
                          "const": "text/calendar; charset=UTF-8"
                        },
                        "ics": {
                          "type": "string"
                        },
                        "utf8Bytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "eventCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 64
                        }
                      },
                      "required": [
                        "mediaType",
                        "ics",
                        "utf8Bytes",
                        "eventCount"
                      ],
                      "additionalProperties": false,
                      "description": "Artifact result for declared profile: rfc5545-standalone-events-v1"
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "icalendar-compose",
                  "version": "0.29.0",
                  "result": {
                    "mediaType": "text/calendar; charset=UTF-8",
                    "ics": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Agent Service Market//Calendar v1//EN\r\nCALSCALE:GREGORIAN\r\nBEGIN:VEVENT\r\nUID:review-1@example.invalid\r\nDTSTAMP:20261005T000000Z\r\nDTSTART;VALUE=DATE:20261006\r\nDTEND;VALUE=DATE:20261007\r\nSUMMARY:Release\\, review\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n",
                    "utf8Bytes": 278,
                    "eventCount": 1
                  },
                  "provenance": {
                    "inputSha256": "67118ef5cf393e82525bbb883eb96fa446c6e40b85e50ed539246327a6c916a3",
                    "outputSha256": "53ec068d2fa3e46651c70748a9c2cfcab39631bb7d0e5dd3a160cd4bce4fbc46",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/sql-select-compile": {
      "post": {
        "operationId": "x402_sql_select_compile",
        "summary": "Bound Single-table SELECT Compiler",
        "description": "Compile one strict single-table SELECT AST for SQLite3 or PostgreSQL18 into quoted SQL, ordered bindings and source paths, with bounded predicates and explicit pagination; never execute SQL.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/sql-select-compile.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compile a bounded SELECT query and parameter bindings from a structured plan",
            "Build a single-table SQLite3 or PostgreSQL18 query handoff without interpolating literal values"
          ],
          "whenToUse": [
            "Compile a bounded SELECT query and parameter bindings from a structured plan",
            "Build a single-table SQLite3 or PostgreSQL18 query handoff without interpolating literal values"
          ],
          "whenNotToUse": [
            "Running SQL, database access, schema/type/permission checks or certifying safe execution",
            "Raw SQL, writes, joins, wildcard, aliases, expressions, functions, subqueries, arbitrary SQL dialects, floats or inferred types",
            "Uploading artifacts, executing database statements, sending invitations, accessing calendars or changing remote state"
          ],
          "capabilities": [
            "Declared profile: single-table-bound-select-v1",
            "Always double-quoted conservative identifiers; strings and safe integers bound separately from SQL",
            "Compare, IN, null checks, nested ALL/ANY/NOT; depth-first ordered binding paths including LIMIT/OFFSET",
            "Explicit SQLite3 ?N or PostgreSQL18 $N placeholders; no terminal semicolon or value interpolation",
            "Query syntax artifacts only; database collation, type affinity, cost and permissions are unverified",
            "Deterministic supplied-input-only artifact; no network, filesystem, database, shell, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "columns": 64,
            "orderBy": 8,
            "identifierBytes": 63,
            "predicateNodes": 128,
            "predicateDepth": 8,
            "membershipValues": 64,
            "parameters": 256,
            "bindingTextBytes": 60000,
            "sqlBytes": 16000,
            "limit": 10000,
            "offset": 1000000,
            "profile": "single-table-bound-select-v1"
          },
          "related": [
            "records-filter",
            "records-project",
            "json-schema-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_IDENTIFIER",
            "DUPLICATE_COLUMN",
            "INVALID_PARAMETER",
            "EMPTY_PREDICATE",
            "PARAMETER_LIMIT",
            "PARAMETER_TEXT_LIMIT",
            "PREDICATE_LIMIT",
            "SQL_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "description": "Declared profile: single-table-bound-select-v1",
                "type": "object",
                "properties": {
                  "dialect": {
                    "type": "string",
                    "enum": [
                      "sqlite3",
                      "postgresql18"
                    ]
                  },
                  "table": {
                    "type": "string",
                    "maxLength": 1000,
                    "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                  },
                  "columns": {
                    "minItems": 1,
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 1000,
                      "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                    }
                  },
                  "where": {
                    "$ref": "#/paths/~1v1~1x402~1sql-select-compile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "orderBy": {
                    "default": [],
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "column": {
                          "type": "string",
                          "maxLength": 1000,
                          "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                        },
                        "direction": {
                          "type": "string",
                          "enum": [
                            "asc",
                            "desc"
                          ]
                        }
                      },
                      "required": [
                        "column",
                        "direction"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "offset": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  }
                },
                "required": [
                  "dialect",
                  "table",
                  "columns",
                  "limit",
                  "offset"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "compare"
                          },
                          "column": {
                            "type": "string",
                            "maxLength": 1000,
                            "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                          },
                          "op": {
                            "type": "string",
                            "enum": [
                              "eq",
                              "ne",
                              "lt",
                              "lte",
                              "gt",
                              "gte"
                            ]
                          },
                          "value": {
                            "anyOf": [
                              {
                                "type": "string",
                                "maxLength": 60000
                              },
                              {
                                "type": "number"
                              }
                            ],
                            "description": "Literal NUL-free Unicode text or a safe integer; never raw SQL"
                          }
                        },
                        "required": [
                          "kind",
                          "column",
                          "op",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "in"
                          },
                          "column": {
                            "type": "string",
                            "maxLength": 1000,
                            "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                          },
                          "values": {
                            "maxItems": 64,
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "maxLength": 60000
                                },
                                {
                                  "type": "number"
                                }
                              ],
                              "description": "Literal NUL-free Unicode text or a safe integer; never raw SQL"
                            }
                          }
                        },
                        "required": [
                          "kind",
                          "column",
                          "values"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "is-null"
                          },
                          "column": {
                            "type": "string",
                            "maxLength": 1000,
                            "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                          }
                        },
                        "required": [
                          "kind",
                          "column"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "is-not-null"
                          },
                          "column": {
                            "type": "string",
                            "maxLength": 1000,
                            "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                          }
                        },
                        "required": [
                          "kind",
                          "column"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "all"
                          },
                          "items": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1x402~1sql-select-compile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          }
                        },
                        "required": [
                          "kind",
                          "items"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "any"
                          },
                          "items": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1x402~1sql-select-compile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          }
                        },
                        "required": [
                          "kind",
                          "items"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "not"
                          },
                          "item": {
                            "$ref": "#/paths/~1v1~1x402~1sql-select-compile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                          }
                        },
                        "required": [
                          "kind",
                          "item"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                }
              },
              "example": {
                "dialect": "postgresql18",
                "table": "tasks",
                "columns": [
                  "id",
                  "title"
                ],
                "where": {
                  "kind": "all",
                  "items": [
                    {
                      "kind": "compare",
                      "column": "state",
                      "op": "eq",
                      "value": "ready"
                    },
                    {
                      "kind": "compare",
                      "column": "priority",
                      "op": "gte",
                      "value": 2
                    }
                  ]
                },
                "orderBy": [
                  {
                    "column": "id",
                    "direction": "asc"
                  }
                ],
                "limit": 10,
                "offset": 0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "sql-select-compile",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "dialect": {
                          "type": "string",
                          "enum": [
                            "sqlite3",
                            "postgresql18"
                          ]
                        },
                        "sql": {
                          "type": "string"
                        },
                        "bindings": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "string",
                                "maxLength": 60000
                              },
                              {
                                "type": "number"
                              }
                            ],
                            "description": "Literal NUL-free Unicode text or a safe integer; never raw SQL"
                          }
                        },
                        "bindingPaths": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "statementCount": {
                          "type": "number",
                          "const": 1
                        },
                        "executed": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "dialect",
                        "sql",
                        "bindings",
                        "bindingPaths",
                        "statementCount",
                        "executed"
                      ],
                      "additionalProperties": false,
                      "description": "Artifact result for declared profile: single-table-bound-select-v1"
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "sql-select-compile",
                  "version": "0.29.0",
                  "result": {
                    "dialect": "postgresql18",
                    "sql": "SELECT \"id\", \"title\" FROM \"tasks\" WHERE (\"state\" = $1 AND \"priority\" >= $2) ORDER BY \"id\" ASC LIMIT $3 OFFSET $4",
                    "bindings": [
                      "ready",
                      2,
                      10,
                      0
                    ],
                    "bindingPaths": [
                      "/where/items/0/value",
                      "/where/items/1/value",
                      "/limit",
                      "/offset"
                    ],
                    "statementCount": 1,
                    "executed": false
                  },
                  "provenance": {
                    "inputSha256": "c469154a069d55fbfdc51d35d602d488d2eadf160e0a41e655056281f02640f5",
                    "outputSha256": "c5ace9156b9a3141378ca64b52da45563bb02e3938768b326825650abbe269e1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/recurrence-dates-expand": {
      "post": {
        "operationId": "x402_recurrence_dates_expand",
        "summary": "Bounded Date Recurrence Expansion",
        "description": "Expand a strict date-only daily, weekly or monthly rule into a complete bounded window, with COUNT/UNTIL, explicit inclusion/exclusion dates and normalized supported RRULE text; no timezone or account access.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/recurrence-dates-expand.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Expand supplied date-only recurrence rules into explicit occurrence dates",
            "Generate complete daily, weekly or monthly dates inside a bounded window with exclusions"
          ],
          "whenToUse": [
            "Expand supplied date-only recurrence rules into explicit occurrence dates",
            "Generate complete daily, weekly or monthly dates inside a bounded window with exclusions"
          ],
          "whenNotToUse": [
            "General RRULE/ICS parsing, time zones, local times, DST, business calendars or finding free appointment slots",
            "Unbounded history, unsupported recurrence selectors, holiday guessing or scheduling account changes",
            "Uploading artifacts, executing database statements, sending invitations, accessing calendars or changing remote state"
          ],
          "capabilities": [
            "Declared profile: rfc5545-date-recurrence-subset-v1",
            "1900–2199 Gregorian dates; DAILY/WEEKLY/MONTHLY, explicit interval and exactly one COUNT or inclusive UNTIL",
            "Weekly selectors use explicit weekStart; monthly invalid dates skip rather than roll; DTSTART must match selectors",
            "COUNT counts valid rule instances before exclusions/window filtering; explicit inclusions union before exclusions",
            "Separate windowComplete and ruleFullyExpanded facts; capped expansion fails atomically instead of returning a truncated prefix",
            "Deterministic supplied-input-only artifact; no network, filesystem, database, shell, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "originToWindowDays": 3660,
            "visitedDates": 3661,
            "ruleCandidates": 3661,
            "count": 512,
            "outputDates": 512,
            "rdates": 256,
            "exdates": 256,
            "interval": 120,
            "years": "1900–2199",
            "profile": "rfc5545-date-recurrence-subset-v1"
          },
          "related": [
            "icalendar-compose",
            "business-calendar-shift",
            "timezone-convert"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_DATE",
            "INVALID_WINDOW",
            "UNSUPPORTED_RULE",
            "UNSYNCHRONIZED_START",
            "RECURRENCE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "description": "Declared profile: rfc5545-date-recurrence-subset-v1",
                "type": "object",
                "properties": {
                  "dtstart": {
                    "type": "string",
                    "maxLength": 10
                  },
                  "window": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "string",
                        "maxLength": 10
                      },
                      "endExclusive": {
                        "type": "string",
                        "maxLength": 10
                      }
                    },
                    "required": [
                      "start",
                      "endExclusive"
                    ],
                    "additionalProperties": false
                  },
                  "rule": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "DAILY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "count": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 512
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "count"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "DAILY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "until": {
                            "type": "string",
                            "maxLength": 10
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "until"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "WEEKLY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "weekdays": {
                            "minItems": 1,
                            "maxItems": 7,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "enum": [
                                "MO",
                                "TU",
                                "WE",
                                "TH",
                                "FR",
                                "SA",
                                "SU"
                              ]
                            }
                          },
                          "weekStart": {
                            "type": "string",
                            "enum": [
                              "MO",
                              "TU",
                              "WE",
                              "TH",
                              "FR",
                              "SA",
                              "SU"
                            ]
                          },
                          "count": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 512
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "weekdays",
                          "weekStart",
                          "count"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "WEEKLY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "weekdays": {
                            "minItems": 1,
                            "maxItems": 7,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "enum": [
                                "MO",
                                "TU",
                                "WE",
                                "TH",
                                "FR",
                                "SA",
                                "SU"
                              ]
                            }
                          },
                          "weekStart": {
                            "type": "string",
                            "enum": [
                              "MO",
                              "TU",
                              "WE",
                              "TH",
                              "FR",
                              "SA",
                              "SU"
                            ]
                          },
                          "until": {
                            "type": "string",
                            "maxLength": 10
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "weekdays",
                          "weekStart",
                          "until"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "MONTHLY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "monthDays": {
                            "minItems": 1,
                            "maxItems": 31,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 31
                            }
                          },
                          "count": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 512
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "monthDays",
                          "count"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "MONTHLY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "monthDays": {
                            "minItems": 1,
                            "maxItems": 31,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 31
                            }
                          },
                          "until": {
                            "type": "string",
                            "maxLength": 10
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "monthDays",
                          "until"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "rdates": {
                    "default": [],
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 10
                    }
                  },
                  "exdates": {
                    "default": [],
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 10
                    }
                  }
                },
                "required": [
                  "dtstart",
                  "window",
                  "rule"
                ],
                "additionalProperties": false
              },
              "example": {
                "dtstart": "2026-01-31",
                "window": {
                  "start": "2026-01-31",
                  "endExclusive": "2026-08-01"
                },
                "rule": {
                  "frequency": "MONTHLY",
                  "interval": 1,
                  "monthDays": [
                    31
                  ],
                  "count": 4
                },
                "rdates": [
                  "2026-02-28"
                ],
                "exdates": [
                  "2026-05-31"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "recurrence-dates-expand",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "dates": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "rrule": {
                          "type": "string"
                        },
                        "ruleInstancesScanned": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 3661
                        },
                        "excludedDatesInWindow": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "windowComplete": {
                          "type": "boolean",
                          "const": true
                        },
                        "ruleFullyExpanded": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "dates",
                        "rrule",
                        "ruleInstancesScanned",
                        "excludedDatesInWindow",
                        "windowComplete",
                        "ruleFullyExpanded"
                      ],
                      "additionalProperties": false,
                      "description": "Artifact result for declared profile: rfc5545-date-recurrence-subset-v1"
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "recurrence-dates-expand",
                  "version": "0.29.0",
                  "result": {
                    "dates": [
                      "2026-01-31",
                      "2026-02-28",
                      "2026-03-31",
                      "2026-07-31"
                    ],
                    "rrule": "FREQ=MONTHLY;INTERVAL=1;BYMONTHDAY=31;COUNT=4",
                    "ruleInstancesScanned": 4,
                    "excludedDatesInWindow": [
                      "2026-05-31"
                    ],
                    "windowComplete": true,
                    "ruleFullyExpanded": true
                  },
                  "provenance": {
                    "inputSha256": "10f5a51bd3092752570d268cb0ea17caaeb18c55f4ea1396f704b7cddd83aef3",
                    "outputSha256": "da2ea7e36399a9f04f5529eaeab5d60cf8e1667974afb4cfd2fada4255de4b10",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/corpus-bm25-search": {
      "post": {
        "operationId": "x402_corpus_bm25_search",
        "summary": "Search a supplied text corpus",
        "description": "Rank supplied documents with fixed-parameter lexical BM25 and exact original UTF-16 token spans. Scores are binary64 logarithm approximations ordered at 12 decimal places, with exact ID ties. No embeddings, persistent index, web search or semantic relevance guarantee.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/corpus-bm25-search.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Rank my supplied documents by lexical BM25",
            "Retrieve matching passages from caller-supplied text with exact token offsets"
          ],
          "whenToUse": [
            "Rank my supplied documents by lexical BM25",
            "Retrieve matching passages from caller-supplied text with exact token offsets"
          ],
          "whenNotToUse": [
            "Web search, semantic/vector search, linguistic segmentation, relevance certification or verifying whether a passage supports a claim",
            "Network calls, external actions, supplied-evidence authenticity or factual correctness certification"
          ],
          "capabilities": [
            "128 supplied documents and 16 queries; k1=1.2, b=0.75; distinct sorted query terms",
            "Unicode Letter/Number followed by Letter/Mark/Number runs, locale-independent lowercase, no normalization",
            "12-decimal approximate scores, exact ID tie-breaks, omitted-candidate and omitted-span evidence",
            "Networkless bounded computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "documents": 128,
            "queries": 16,
            "corpusBytes": 60000,
            "documentBytes": 20000,
            "corpusTokens": 12000,
            "corpusTerms": 4096,
            "queryTerms": 64,
            "queryCodePoints": 512,
            "tokenCodePoints": 128,
            "topK": 20,
            "hitSpans": 20,
            "contributionChecks": 131072
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "TEXT_LIMIT",
            "TOKEN_LIMIT",
            "TERM_LIMIT",
            "TOKEN_LENGTH_LIMIT"
          ],
          "related": [
            "text-chunk",
            "ranking-evaluate",
            "context-budget-pack"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "documents": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 20000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "queries": {
                    "minItems": 1,
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 1024
                        },
                        "topK": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 20
                        }
                      },
                      "required": [
                        "id",
                        "text",
                        "topK"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "documents",
                  "queries"
                ],
                "additionalProperties": false
              },
              "example": {
                "documents": [
                  {
                    "id": "d1",
                    "text": "red fox"
                  },
                  {
                    "id": "d2",
                    "text": "blue dog"
                  }
                ],
                "queries": [
                  {
                    "id": "q1",
                    "text": "red",
                    "topK": 2
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "corpus-bm25-search",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "profile": {
                          "type": "string",
                          "const": "supplied-unicode-word-bm25-v1"
                        },
                        "documentCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "tokenCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "queries": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "ranked",
                                  "empty-query"
                                ]
                              },
                              "terms": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "maxLength": 512
                                }
                              },
                              "candidateCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "omittedCandidates": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "hits": {
                                "maxItems": 20,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    "sourceIndex": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "score": {
                                      "type": "string",
                                      "pattern": "^\\d+\\.\\d{12}$"
                                    },
                                    "matchedTerms": {
                                      "maxItems": 64,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "maxLength": 512
                                      }
                                    },
                                    "spans": {
                                      "maxItems": 20,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "term": {
                                            "type": "string",
                                            "maxLength": 512
                                          },
                                          "start": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "end": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "term",
                                          "start",
                                          "end"
                                        ],
                                        "additionalProperties": false
                                      }
                                    },
                                    "omittedSpans": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "sourceIndex",
                                    "score",
                                    "matchedTerms",
                                    "spans",
                                    "omittedSpans"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "id",
                              "status",
                              "terms",
                              "candidateCount",
                              "omittedCandidates",
                              "hits"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "semanticRelevanceVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "scoreArithmetic": {
                          "type": "string",
                          "const": "binary64-logarithm-approximation"
                        },
                        "scoreOrdering": {
                          "type": "string",
                          "const": "fixed-12-decimal-score-descending-then-UTF16-id"
                        },
                        "offsetUnits": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        }
                      },
                      "required": [
                        "advisoryOnly",
                        "externalRequests",
                        "profile",
                        "documentCount",
                        "tokenCount",
                        "queries",
                        "semanticRelevanceVerified",
                        "scoreArithmetic",
                        "scoreOrdering",
                        "offsetUnits"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "corpus-bm25-search",
                  "version": "0.29.0",
                  "result": {
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "profile": "supplied-unicode-word-bm25-v1",
                    "documentCount": 2,
                    "tokenCount": 4,
                    "queries": [
                      {
                        "id": "q1",
                        "status": "ranked",
                        "terms": [
                          "red"
                        ],
                        "candidateCount": 1,
                        "omittedCandidates": 0,
                        "hits": [
                          {
                            "id": "d1",
                            "sourceIndex": 0,
                            "score": "0.693147180560",
                            "matchedTerms": [
                              "red"
                            ],
                            "spans": [
                              {
                                "term": "red",
                                "start": 0,
                                "end": 3
                              }
                            ],
                            "omittedSpans": 0
                          }
                        ]
                      }
                    ],
                    "semanticRelevanceVerified": false,
                    "scoreArithmetic": "binary64-logarithm-approximation",
                    "scoreOrdering": "fixed-12-decimal-score-descending-then-UTF16-id",
                    "offsetUnits": "UTF-16 code units; zero-based, end-exclusive"
                  },
                  "provenance": {
                    "inputSha256": "b0875c7142d0bbaaced040f155f697415bc61a604d6f69e4dda2ab57deae1de9",
                    "outputSha256": "39eac80fbdd9d2318a7ab087a0a3fe92145f6ddb0ebfa26619059e4e5ffaa7d2",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/decimal-distribution-summarize": {
      "post": {
        "operationId": "x402_decimal_distribution_summarize",
        "summary": "Summarize exact decimal observations",
        "description": "Compute exact reduced-rational descriptive statistics and R type-7 quantiles from supplied decimal strings. Explicit null/error-or-omit policy, empty and singleton results, exact population/sample variance. No square roots, weighting, units, uncertainty or population inference.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/decimal-distribution-summarize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compute exact descriptive mean, variance, median and R7 percentiles from supplied decimal measurements",
            "Summarize decimal observations with explicit missing-value omission evidence"
          ],
          "whenToUse": [
            "Compute exact descriptive mean, variance, median and R7 percentiles from supplied decimal measurements",
            "Summarize decimal observations with explicit missing-value omission evidence"
          ],
          "whenNotToUse": [
            "Significance testing, confidence intervals, population estimates, verified measurements, standard deviation or automatic missing-value imputation",
            "Network calls, external actions, supplied-evidence authenticity or factual correctness certification"
          ],
          "capabilities": [
            "Exact decimal strings up to 24 integer and 18 fraction digits, reduced rational results",
            "R type-7 interpolation only; probability order retained and numerical duplicates reject",
            "Missing indexes explicit; empty observations return zero sum and null other statistics",
            "Networkless bounded computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "values": 1000,
            "quantiles": 21,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "arithmeticWorkSteps": 100000,
            "quantileMethod": "R7"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "MISSING_VALUE",
            "INVALID_PROBABILITY",
            "DUPLICATE_PROBABILITY",
            "NUMERIC_COMPLEXITY"
          ],
          "related": [
            "localized-number-parse",
            "records-aggregate",
            "numeric-rounding-check"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "values": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "missing": {
                    "type": "string",
                    "enum": [
                      "error",
                      "omit"
                    ]
                  },
                  "quantiles": {
                    "maxItems": 21,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 43,
                      "pattern": "^(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$"
                    }
                  }
                },
                "required": [
                  "values",
                  "missing",
                  "quantiles"
                ],
                "additionalProperties": false
              },
              "example": {
                "values": [
                  "1.2",
                  "2.4",
                  "4.8",
                  "7.2",
                  null
                ],
                "missing": "omit",
                "quantiles": [
                  "0.25"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "decimal-distribution-summarize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "profile": {
                          "type": "string",
                          "const": "exact-decimal-r7-summary-v1"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "summarized",
                            "empty"
                          ]
                        },
                        "inputCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "observedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "missingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "omittedIndexes": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          }
                        },
                        "sum": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "min": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "max": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "mean": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "median": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "populationVariance": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "sampleVariance": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "quantiles": {
                          "maxItems": 21,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "probability": {
                                "type": "string",
                                "maxLength": 43
                              },
                              "value": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "probability",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "quantileMethod": {
                          "type": "string",
                          "const": "R7"
                        },
                        "populationInference": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "advisoryOnly",
                        "externalRequests",
                        "profile",
                        "status",
                        "inputCount",
                        "observedCount",
                        "missingCount",
                        "omittedIndexes",
                        "sum",
                        "min",
                        "max",
                        "mean",
                        "median",
                        "populationVariance",
                        "sampleVariance",
                        "quantiles",
                        "quantileMethod",
                        "populationInference"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "decimal-distribution-summarize",
                  "version": "0.29.0",
                  "result": {
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "profile": "exact-decimal-r7-summary-v1",
                    "status": "summarized",
                    "inputCount": 5,
                    "observedCount": 4,
                    "missingCount": 1,
                    "omittedIndexes": [
                      4
                    ],
                    "sum": {
                      "numerator": "78",
                      "denominator": "5"
                    },
                    "min": {
                      "numerator": "6",
                      "denominator": "5"
                    },
                    "max": {
                      "numerator": "36",
                      "denominator": "5"
                    },
                    "mean": {
                      "numerator": "39",
                      "denominator": "10"
                    },
                    "median": {
                      "numerator": "18",
                      "denominator": "5"
                    },
                    "populationVariance": {
                      "numerator": "531",
                      "denominator": "100"
                    },
                    "sampleVariance": {
                      "numerator": "177",
                      "denominator": "25"
                    },
                    "quantiles": [
                      {
                        "probability": "0.25",
                        "value": {
                          "numerator": "21",
                          "denominator": "10"
                        }
                      }
                    ],
                    "quantileMethod": "R7",
                    "populationInference": false
                  },
                  "provenance": {
                    "inputSha256": "ba43b753b426000bc85f40d002986e7142da63e0e6543574b4175efdf716f060",
                    "outputSha256": "446f17493b36b940a6b3bd24349ac063e1915aafda0117a8c72a76aea9460984",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/message-variants-render": {
      "post": {
        "operationId": "x402_message_variants_render",
        "summary": "Render supplied message variants",
        "description": "Render bounded literal/argument/select/plural message trees for explicit cases using fixed CLDR47 integer cardinal rules for en/de/ja/ar/pt-BR/pt-PT. Exact branches precede categories; other is required. Returns selected branches and finite case coverage. No translation, escaping, ICU syntax or runtime Intl dependency.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/message-variants-render.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Render supplied plural/select messages into concrete localized preview strings",
            "Preview fixed integer cardinal branches and finite case coverage for supplied message trees"
          ],
          "whenToUse": [
            "Render supplied plural/select messages into concrete localized preview strings",
            "Preview fixed integer cardinal branches and finite case coverage for supplied message trees"
          ],
          "whenNotToUse": [
            "Translate or verify language quality; parse full ICU MessageFormat; decimal/ordinal plurals; format dates/numbers; send messages; escape HTML or SQL",
            "Network calls, external actions, supplied-evidence authenticity or factual correctness certification"
          ],
          "capabilities": [
            "Flat unique-ownership fully reachable trees with all branches and variables validated before rendering",
            "CLDR47-derived integer-only en/de/ja/ar/pt-BR/pt-PT cardinal rules, no locale fallback or runtime Intl",
            "Exact-value overrides and required other branches, literal substitution, branch coverage over supplied cases only",
            "Networkless bounded computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "nodes": 512,
            "branchDepth": 8,
            "branchesPerChoice": 16,
            "variables": 128,
            "cases": 128,
            "literalValueBytes": 60000,
            "caseTextBytes": 20000,
            "totalTextBytes": 200000,
            "renderNodeVisits": 65536,
            "pluralCountMaximum": 1000000000,
            "cldrVersion": "47"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "INVALID_MESSAGE_TREE",
            "DUPLICATE_BRANCH",
            "MISSING_OTHER",
            "VARIABLE_TYPE_CONFLICT",
            "MISSING_VARIABLE",
            "EXTRA_VARIABLE",
            "INVALID_COUNT",
            "TEXT_LIMIT",
            "RENDER_LIMIT"
          ],
          "related": [
            "localization-bundle-build",
            "template-render"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "locale": {
                    "type": "string",
                    "enum": [
                      "en",
                      "de",
                      "ja",
                      "ar",
                      "pt-BR",
                      "pt-PT"
                    ]
                  },
                  "root": {
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 511
                    }
                  },
                  "nodes": {
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "text"
                            },
                            "text": {
                              "type": "string",
                              "maxLength": 60000
                            }
                          },
                          "required": [
                            "kind",
                            "text"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "arg"
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64,
                              "pattern": "^[A-Za-z_][A-Za-z0-9_.-]*$"
                            }
                          },
                          "required": [
                            "kind",
                            "name"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "select"
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64,
                              "pattern": "^[A-Za-z_][A-Za-z0-9_.-]*$"
                            },
                            "options": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "key": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "nodes": {
                                    "maxItems": 512,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 511
                                    }
                                  }
                                },
                                "required": [
                                  "key",
                                  "nodes"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "kind",
                            "name",
                            "options"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "plural"
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64,
                              "pattern": "^[A-Za-z_][A-Za-z0-9_.-]*$"
                            },
                            "exact": {
                              "default": [],
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "value": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000000000
                                  },
                                  "nodes": {
                                    "maxItems": 512,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 511
                                    }
                                  }
                                },
                                "required": [
                                  "value",
                                  "nodes"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "categories": {
                              "minItems": 1,
                              "maxItems": 6,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "category": {
                                    "type": "string",
                                    "enum": [
                                      "zero",
                                      "one",
                                      "two",
                                      "few",
                                      "many",
                                      "other"
                                    ]
                                  },
                                  "nodes": {
                                    "maxItems": 512,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 511
                                    }
                                  }
                                },
                                "required": [
                                  "category",
                                  "nodes"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "kind",
                            "name",
                            "categories"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  },
                  "cases": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "variables": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64,
                            "pattern": "^[A-Za-z_][A-Za-z0-9_.-]*$"
                          },
                          "additionalProperties": {
                            "anyOf": [
                              {
                                "type": "string",
                                "maxLength": 60000
                              },
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              }
                            ]
                          }
                        }
                      },
                      "required": [
                        "id",
                        "variables"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "locale",
                  "root",
                  "nodes",
                  "cases"
                ],
                "additionalProperties": false
              },
              "example": {
                "locale": "en",
                "root": [
                  0,
                  1,
                  2,
                  3
                ],
                "nodes": [
                  {
                    "kind": "text",
                    "text": "Hello "
                  },
                  {
                    "kind": "arg",
                    "name": "name"
                  },
                  {
                    "kind": "text",
                    "text": ", "
                  },
                  {
                    "kind": "plural",
                    "name": "count",
                    "exact": [
                      {
                        "value": 0,
                        "nodes": [
                          4
                        ]
                      }
                    ],
                    "categories": [
                      {
                        "category": "one",
                        "nodes": [
                          5
                        ]
                      },
                      {
                        "category": "other",
                        "nodes": [
                          6,
                          7
                        ]
                      }
                    ]
                  },
                  {
                    "kind": "text",
                    "text": "no files"
                  },
                  {
                    "kind": "text",
                    "text": "one file"
                  },
                  {
                    "kind": "arg",
                    "name": "count"
                  },
                  {
                    "kind": "text",
                    "text": " files"
                  }
                ],
                "cases": [
                  {
                    "id": "none",
                    "variables": {
                      "name": "Ana",
                      "count": 0
                    }
                  },
                  {
                    "id": "several",
                    "variables": {
                      "name": "Ana",
                      "count": 2
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "message-variants-render",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "profile": {
                          "type": "string",
                          "const": "bounded-message-tree-cldr47-integer-v1"
                        },
                        "locale": {
                          "type": "string",
                          "enum": [
                            "en",
                            "de",
                            "ja",
                            "ar",
                            "pt-BR",
                            "pt-PT"
                          ]
                        },
                        "cases": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "text": {
                                "type": "string",
                                "maxLength": 20000
                              },
                              "branches": {
                                "maxItems": 512,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "node": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "selected": {
                                      "type": "string",
                                      "maxLength": 100
                                    }
                                  },
                                  "required": [
                                    "node",
                                    "selected"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "id",
                              "text",
                              "branches"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "coverage": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "node": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "visited": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "maxLength": 100
                                }
                              },
                              "unvisited": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "node",
                              "visited",
                              "unvisited"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "translationVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "escaped": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "advisoryOnly",
                        "externalRequests",
                        "profile",
                        "locale",
                        "cases",
                        "coverage",
                        "translationVerified",
                        "escaped"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "message-variants-render",
                  "version": "0.29.0",
                  "result": {
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "profile": "bounded-message-tree-cldr47-integer-v1",
                    "locale": "en",
                    "cases": [
                      {
                        "id": "none",
                        "text": "Hello Ana, no files",
                        "branches": [
                          {
                            "node": 3,
                            "selected": "=0"
                          }
                        ]
                      },
                      {
                        "id": "several",
                        "text": "Hello Ana, 2 files",
                        "branches": [
                          {
                            "node": 3,
                            "selected": "other"
                          }
                        ]
                      }
                    ],
                    "coverage": [
                      {
                        "node": 3,
                        "visited": [
                          "=0",
                          "other"
                        ],
                        "unvisited": [
                          "one"
                        ]
                      }
                    ],
                    "translationVerified": false,
                    "escaped": false
                  },
                  "provenance": {
                    "inputSha256": "9c6f1456c7c70aec965865d71fcd320490baa18b73493f18455d3a7dde5e7d88",
                    "outputSha256": "1097155c3e335474e79c1efb7ed8ed6d15ad7d54090e1723725e2d191324b07c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/svg-bar-chart-compose": {
      "post": {
        "operationId": "x402_svg_bar_chart_compose",
        "summary": "Compose a fixed SVG bar chart",
        "description": "Turn 1–24 supplied labeled nonnegative integer values and an explicit domain into an inert accessible horizontal bar-chart SVG, plain-text alternative and exact geometry.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/svg-bar-chart-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate a standalone SVG bar chart from computed counts",
            "Create a deterministic horizontal chart and text alternative"
          ],
          "whenToUse": [
            "Already-computed nonnegative integer rows with a caller-selected zero-based domain"
          ],
          "whenNotToUse": [
            "Aggregating data, inferring domains, negative/fractional values, log scales, stacked bars or time axes",
            "Rendering, printing, writing files, uploading, publishing, or changing remote state",
            "Supplying custom SVG, HTML, CSS, fonts, images, links, scripts or external resources",
            "Guaranteeing font appearance, printer alignment, source authenticity or accessibility compliance"
          ],
          "capabilities": [
            "Ordered fixed geometry, visible exact values, title/description and caller-prefixed accessible IDs",
            "Escaped literal text in an original fixed inert SVG serializer",
            "Deterministic supplied-input-only artifact with no network, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "svg-nonnegative-horizontal-bars-v1",
            "rows": 24,
            "labelAsciiCharacters": 16,
            "titleScalars": 80,
            "idPrefixCharacters": 32,
            "maximumValue": 1000000000,
            "widthPixels": 720,
            "maximumProjectedResultBytes": 30560
          },
          "related": [
            "decimal-distribution-summarize",
            "records-aggregate",
            "label-sheet-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "TITLE_LIMIT",
            "EMPTY_TITLE",
            "INVALID_TEXT_CONTROL",
            "VALUE_OUTSIDE_DOMAIN"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "idPrefix": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,31}$"
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160,
                    "description": "1–80 Unicode scalars; no controls or XML-disallowed characters"
                  },
                  "domainMax": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000000
                  },
                  "rows": {
                    "minItems": 1,
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 16,
                          "pattern": "^[\\x20-\\x7e]+$"
                        },
                        "value": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000
                        }
                      },
                      "required": [
                        "label",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "idPrefix",
                  "title",
                  "domainMax",
                  "rows"
                ],
                "additionalProperties": false
              },
              "example": {
                "idPrefix": "sales",
                "title": "Units",
                "domainMax": 10,
                "rows": [
                  {
                    "label": "A",
                    "value": 5
                  },
                  {
                    "label": "B",
                    "value": 10
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "svg-bar-chart-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "svg": {
                          "type": "string"
                        },
                        "textAlternative": {
                          "type": "string"
                        },
                        "bars": {
                          "minItems": 1,
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 23
                              },
                              "x": {
                                "type": "number",
                                "const": 180
                              },
                              "y": {
                                "type": "integer",
                                "minimum": 32,
                                "maximum": 768
                              },
                              "width": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 400
                              },
                              "height": {
                                "type": "number",
                                "const": 24
                              }
                            },
                            "required": [
                              "inputIndex",
                              "x",
                              "y",
                              "width",
                              "height"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "svg",
                        "textAlternative",
                        "bars"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "svg-bar-chart-compose",
                  "version": "0.29.0",
                  "result": {
                    "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" xml:space=\"preserve\" width=\"720\" height=\"108\" viewBox=\"0 0 720 108\" role=\"img\" aria-labelledby=\"sales-title sales-desc\"><title id=\"sales-title\">Units</title><desc id=\"sales-desc\">Domain 0 to 10. A: 5; B: 10.</desc><rect width=\"720\" height=\"108\" fill=\"#fff\"/><g fill=\"#000\" font-family=\"monospace\" font-size=\"12\"><text x=\"16\" y=\"20\" textLength=\"36\" lengthAdjust=\"spacingAndGlyphs\">Units</text><text x=\"16\" y=\"50\">A</text><text x=\"700\" y=\"50\" text-anchor=\"end\">5</text><text x=\"16\" y=\"82\">B</text><text x=\"700\" y=\"82\" text-anchor=\"end\">10</text></g><g fill=\"#2457a7\"><rect x=\"180\" y=\"32\" width=\"200\" height=\"24\"/><rect x=\"180\" y=\"64\" width=\"400\" height=\"24\"/></g></svg>\n",
                    "textAlternative": "Units. Domain 0 to 10. A: 5; B: 10.",
                    "bars": [
                      {
                        "inputIndex": 0,
                        "x": 180,
                        "y": 32,
                        "width": 200,
                        "height": 24
                      },
                      {
                        "inputIndex": 1,
                        "x": 180,
                        "y": 64,
                        "width": 400,
                        "height": 24
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "973f898ca2fb35ca2355c298cede3e4fe15e672477d8181c49a61671c6c220b6",
                    "outputSha256": "a8462700e0da6472b73dddabd13ff57e87822365aa8209868de4fe65ae424fce",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/label-sheet-compose": {
      "post": {
        "operationId": "x402_label_sheet_compose",
        "summary": "Compose printable SVG label sheets",
        "description": "Fit 1–100 short ASCII labels onto supplied integer-micrometre stock, skip first-page used slots and return deterministic row-major placements and up to 20 inert printable SVG sheets.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/label-sheet-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate printable vector inventory label sheets",
            "Paginate short labels into a physical stock grid with used first-page slots"
          ],
          "whenToUse": [
            "Explicit micrometre page, margin, gap and cell dimensions with one short line per label"
          ],
          "whenNotToUse": [
            "Printer control, barcode generation, postal verification, rotation, optimal nesting, supplied fonts or automatic text fitting",
            "Rendering, printing, writing files, uploading, publishing, or changing remote state",
            "Supplying custom SVG, HTML, CSS, fonts, images, links, scripts or external resources",
            "Guaranteeing font appearance, printer alignment, source authenticity or accessibility compliance"
          ],
          "capabilities": [
            "Exact integer grid, physical millimetre SVG sizes, occupied-cell outlines and ordered placement manifest",
            "Explicit 3/5-em text advance, quarter-em descent reserve and fixed 2,000 micrometre padding",
            "Escaped literal text in an original fixed inert SVG serializer",
            "Deterministic supplied-input-only artifact with no network, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "micrometre-grid-labels-v1",
            "labels": 100,
            "labelAsciiCharacters": 16,
            "pages": 20,
            "pageDimensionUm": 1000000,
            "minimumMarginUm": 50,
            "outlineStrokeUm": 100,
            "paddingUm": 2000,
            "descentReserve": "ceil(fontSizeUm / 4)",
            "maximumProjectedResultBytes": 111000
          },
          "related": [
            "svg-bar-chart-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "LABEL_WHITESPACE",
            "LABEL_TEXT_FIT",
            "NO_LABEL_CAPACITY",
            "START_SLOT_OUTSIDE_GRID",
            "PAGE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "pageWidthUm": {
                    "type": "integer",
                    "minimum": 10000,
                    "maximum": 1000000
                  },
                  "pageHeightUm": {
                    "type": "integer",
                    "minimum": 10000,
                    "maximum": 1000000
                  },
                  "marginXUm": {
                    "type": "integer",
                    "minimum": 50,
                    "maximum": 1000000
                  },
                  "marginYUm": {
                    "type": "integer",
                    "minimum": 50,
                    "maximum": 1000000
                  },
                  "labelWidthUm": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000
                  },
                  "labelHeightUm": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000
                  },
                  "gapXUm": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "gapYUm": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "fontSizeUm": {
                    "type": "integer",
                    "minimum": 1000,
                    "maximum": 10000
                  },
                  "startSlot": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "labels": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 16,
                      "pattern": "^[\\x20-\\x7e]+$"
                    }
                  }
                },
                "required": [
                  "pageWidthUm",
                  "pageHeightUm",
                  "marginXUm",
                  "marginYUm",
                  "labelWidthUm",
                  "labelHeightUm",
                  "gapXUm",
                  "gapYUm",
                  "fontSizeUm",
                  "startSlot",
                  "labels"
                ],
                "additionalProperties": false
              },
              "example": {
                "pageWidthUm": 100000,
                "pageHeightUm": 60000,
                "marginXUm": 5000,
                "marginYUm": 5000,
                "labelWidthUm": 40000,
                "labelHeightUm": 20000,
                "gapXUm": 10000,
                "gapYUm": 10000,
                "fontSizeUm": 3000,
                "startSlot": 0,
                "labels": [
                  "A-01",
                  "B-02"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "label-sheet-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "columns": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000
                        },
                        "rows": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000
                        },
                        "capacityPerPage": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000
                        },
                        "pageCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 20
                        },
                        "placements": {
                          "minItems": 1,
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 99
                              },
                              "pageIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 19
                              },
                              "row": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              },
                              "column": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              },
                              "xUm": {
                                "type": "integer",
                                "minimum": 50,
                                "maximum": 1000000
                              },
                              "yUm": {
                                "type": "integer",
                                "minimum": 50,
                                "maximum": 1000000
                              },
                              "widthUm": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 1000000
                              },
                              "heightUm": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 1000000
                              }
                            },
                            "required": [
                              "inputIndex",
                              "pageIndex",
                              "row",
                              "column",
                              "xUm",
                              "yUm",
                              "widthUm",
                              "heightUm"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "pages": {
                          "minItems": 1,
                          "maxItems": 20,
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "columns",
                        "rows",
                        "capacityPerPage",
                        "pageCount",
                        "placements",
                        "pages"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "label-sheet-compose",
                  "version": "0.29.0",
                  "result": {
                    "columns": 2,
                    "rows": 2,
                    "capacityPerPage": 4,
                    "pageCount": 1,
                    "placements": [
                      {
                        "inputIndex": 0,
                        "pageIndex": 0,
                        "row": 0,
                        "column": 0,
                        "xUm": 5000,
                        "yUm": 5000,
                        "widthUm": 40000,
                        "heightUm": 20000
                      },
                      {
                        "inputIndex": 1,
                        "pageIndex": 0,
                        "row": 0,
                        "column": 1,
                        "xUm": 55000,
                        "yUm": 5000,
                        "widthUm": 40000,
                        "heightUm": 20000
                      }
                    ],
                    "pages": [
                      "<svg xmlns=\"http://www.w3.org/2000/svg\" xml:space=\"preserve\" width=\"100mm\" height=\"60mm\" viewBox=\"0 0 100000 60000\" role=\"img\"><title>Label sheet 1 of 1</title><g fill=\"none\" stroke=\"#000\" stroke-width=\"100\"><rect x=\"5000\" y=\"5000\" width=\"40000\" height=\"20000\"/><rect x=\"55000\" y=\"5000\" width=\"40000\" height=\"20000\"/></g><g fill=\"#000\" font-family=\"monospace\" font-size=\"3000\"><text x=\"7000\" y=\"10000\" textLength=\"7200\" lengthAdjust=\"spacingAndGlyphs\">A-01</text><text x=\"57000\" y=\"10000\" textLength=\"7200\" lengthAdjust=\"spacingAndGlyphs\">B-02</text></g></svg>\n"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "d99f5928e42fe224c3552c626fdcc2e8132b68bc3aee914dac3ce1aea312c353",
                    "outputSha256": "2120862f692df28a7678a5660b924ae72e56404af7aa1b2d4f823ed7cc929da7",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/ustar-bundle-compose": {
      "post": {
        "operationId": "x402_ustar_bundle_compose",
        "summary": "Reproducible portable USTAR bundle composer",
        "description": "WHEN TO USE: Package 1–32 supplied named UTF-8 or binary artifacts into exact reproducible regular-file USTAR bytes, canonical Base64, SHA-256 and a sorted source-index/offset manifest. Restricted portable ASCII relative paths, fixed nonexecutable metadata, no compression, archive extraction, filesystem reads/writes or universal safe-extraction claim.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/ustar-bundle-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Package supplied named artifacts as an exact reproducible tar archive",
            "Create a byte-addressed bundle with content hashes and source indexes"
          ],
          "whenToUse": [
            "Package supplied named artifacts as an exact reproducible tar archive",
            "Create a byte-addressed bundle with content hashes and source indexes"
          ],
          "whenNotToUse": [
            "ZIP, gzip, compression, directories, links, devices, executable modes, permissions or ownership preservation",
            "Reading paths, extracting archives, PAX/GNU extensions or universal cross-platform extraction safety",
            "Sending, uploading, extracting archives, writing files, authenticating identities, or changing external state"
          ],
          "capabilities": [
            "Profile portable-regular-ustar-v1; ASCII-byte path ordering with case-insensitive collision rejection",
            "Fixed 0644 regular files; zero uid/gid/mtime, empty owner names; exact two-block terminator",
            "SHA-256 over decoded bytes; sidecar manifest is not an archive member",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "portable-regular-ustar-v1",
            "files": 32,
            "pathBytes": 100,
            "segmentBytes": 64,
            "payloadBytes": 60000,
            "archiveBytes": 93696,
            "extraction": "never performed; consumers still require safe extraction"
          },
          "related": [
            "oci-artifact-compose",
            "multipart-form-encode",
            "content-digest"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_PATH",
            "DUPLICATE_PATH",
            "PATH_COLLISION",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "ARCHIVE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "files": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 80000
                        }
                      },
                      "required": [
                        "path",
                        "encoding",
                        "data"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "files"
                ],
                "additionalProperties": false
              },
              "example": {
                "files": [
                  {
                    "path": "a.txt",
                    "encoding": "utf8",
                    "data": "hi\n"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "ustar-bundle-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "encoding": {
                          "type": "string",
                          "const": "base64"
                        },
                        "archive": {
                          "type": "string",
                          "maxLength": 124928
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1536,
                          "maximum": 93696
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "manifest": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 31
                              },
                              "path": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "byteLength": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "sha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "headerOffset": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 92160
                              },
                              "dataOffset": {
                                "type": "integer",
                                "minimum": 512,
                                "maximum": 92672
                              }
                            },
                            "required": [
                              "inputIndex",
                              "path",
                              "byteLength",
                              "sha256",
                              "headerOffset",
                              "dataOffset"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "encoding",
                        "archive",
                        "byteLength",
                        "sha256",
                        "manifest"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "ustar-bundle-compose",
                  "version": "0.29.0",
                  "result": {
                    "encoding": "base64",
                    "archive": "YS50eHQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAwMDA2NDQAMDAwMDAwMAAwMDAwMDAwADAwMDAwMDAwMDAzADAwMDAwMDAwMDAwADAwNjcxNwAgMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB1c3RhcgAwMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABoaQoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=",
                    "byteLength": 2048,
                    "sha256": "8909eea3aedf7c1309a054eed68c58f7506ca7e9fcb198beb7e89b408912d827",
                    "manifest": [
                      {
                        "inputIndex": 0,
                        "path": "a.txt",
                        "byteLength": 3,
                        "sha256": "98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4",
                        "headerOffset": 0,
                        "dataOffset": 512
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "466d72e01f0ff4307aa75b44e6b6878bb3d1a57ccf05469a06d81e78042cef93",
                    "outputSha256": "88111b382c61bb554da6987a518ee9bb429f99606ebcfa5e4c95f9f97953c921",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/mime-email-compose": {
      "post": {
        "operationId": "x402_mime_email_compose",
        "summary": "Inert RFC email message composer",
        "description": "WHEN TO USE: Create exact inert .eml message text from caller-supplied From, ordered To, UTC timestamp, Message-ID, subject and text. Restricted ASCII mailboxes, deterministic MIME Base64 UTF-8 body and safe folded encoded subjects. Does not send email, create mailbox drafts, authenticate identities, look up domains or promise delivery.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/mime-email-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compose a complete deterministic .eml draft artifact for later caller-controlled import or transport",
            "Encode explicit sender, recipients, timestamp, message ID and plain text as an RFC MIME message"
          ],
          "whenToUse": [
            "Compose a complete deterministic .eml draft artifact for later caller-controlled import or transport",
            "Encode explicit sender, recipients, timestamp, message ID and plain text as an RFC MIME message"
          ],
          "whenNotToUse": [
            "Sending email, mailbox access, deliverability checks, DNS or authenticated sender identity",
            "HTML, attachments, display names, quoted mailboxes, groups, SMTPUTF8, Cc/Bcc, custom headers or DKIM",
            "Sending, uploading, extracting archives, writing files, authenticating identities, or changing external state"
          ],
          "capabilities": [
            "Profile rfc5322-text-message-v1; eight fixed headers and Base64 text/plain UTF-8",
            "Supplied whole-second UTC date and message ID; exact CRLF body normalization without adding decoded newlines",
            "Subject encoded words split only at scalar boundaries; literal encoded-word-looking text cannot become MIME syntax",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "rfc5322-text-message-v1",
            "recipients": 10,
            "mailboxBytes": 254,
            "localPartBytes": 64,
            "subjectScalars": 200,
            "subjectBytes": 600,
            "sourceBodyBytes": 40000,
            "canonicalBodyBytes": 40000,
            "wireBytes": 70000,
            "headerLineBytes": 998,
            "encodedWordSourceBytes": 42,
            "identities": "caller claims, not authenticated"
          },
          "related": [
            "multipart-form-encode",
            "icalendar-compose",
            "email-domain-readiness"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_MAILBOX",
            "INVALID_TIMESTAMP",
            "HEADER_CONTROL",
            "DUPLICATE_RECIPIENT",
            "SUBJECT_LIMIT",
            "SUBJECT_WHITESPACE",
            "BODY_CONTROL",
            "TEXT_LIMIT",
            "HEADER_LIMIT",
            "WIRE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "from": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 254
                  },
                  "to": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 3,
                      "maxLength": 254
                    }
                  },
                  "sentAt": {
                    "type": "string",
                    "minLength": 20,
                    "maxLength": 20
                  },
                  "messageId": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 254
                  },
                  "subject": {
                    "type": "string",
                    "maxLength": 400
                  },
                  "text": {
                    "type": "string",
                    "maxLength": 40000
                  }
                },
                "required": [
                  "from",
                  "to",
                  "sentAt",
                  "messageId",
                  "subject",
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "from": "a@example.invalid",
                "to": [
                  "b@example.invalid"
                ],
                "sentAt": "2026-10-05T00:00:00Z",
                "messageId": "demo@example.invalid",
                "subject": "Test",
                "text": "Oi\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "mime-email-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "eml": {
                          "type": "string",
                          "maxLength": 70000
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 70000
                        },
                        "canonicalText": {
                          "type": "string",
                          "maxLength": 40000
                        }
                      },
                      "required": [
                        "eml",
                        "byteLength",
                        "canonicalText"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "mime-email-compose",
                  "version": "0.29.0",
                  "result": {
                    "eml": "From: a@example.invalid\r\nTo: b@example.invalid\r\nDate: Mon, 05 Oct 2026 00:00:00 +0000\r\nMessage-ID: <demo@example.invalid>\r\nSubject: Test\r\nMIME-Version: 1.0\r\nContent-Type: text/plain; charset=UTF-8\r\nContent-Transfer-Encoding: base64\r\n\r\nT2kNCg==\r\n",
                    "byteLength": 245,
                    "canonicalText": "Oi\r\n"
                  },
                  "provenance": {
                    "inputSha256": "3f095540c31fbbb0c75d82e8d8f54fbceb17631950ed8c38ee5ab13214d1de60",
                    "outputSha256": "ce2296649f70300609d6e02b285b90485aa4e22b3f73ea5eeb392d1d3c42b489",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/gfm-table-compose": {
      "post": {
        "operationId": "x402_gfm_table_compose",
        "summary": "Literal-cell GFM table composer",
        "description": "WHEN TO USE: Turn an explicit rectangular string matrix into a paste-ready GitHub Flavored Markdown table with exact literal-cell escaping and supplied column alignments. Escapes every ASCII punctuation character, preserving cell text in the declared GFM profile. ASCII @ is rejected to prevent GFM email autolinks. No raw Markdown, HTML, links, newline substitution, display-width padding or non-GFM rendering guarantee.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/gfm-table-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compose paste-ready literal-cell GFM tables from supplied rows",
            "Serialize a rectangular string matrix as Markdown with explicit column alignments"
          ],
          "whenToUse": [
            "Compose paste-ready literal-cell GFM tables from supplied rows",
            "Serialize a rectangular string matrix as Markdown with explicit column alignments"
          ],
          "whenNotToUse": [
            "ASCII @ or email-address cells; GFM email autolinking cannot be suppressed with punctuation escapes",
            "Parsing tables, CSV conversion, raw Markdown or HTML cells, links, code spans or multiline cells",
            "Pixel alignment, display-width padding or exact behavior on non-GFM renderers; browsers may collapse repeated spaces",
            "Sending, uploading, extracting archives, writing files, authenticating identities, or changing external state"
          ],
          "capabilities": [
            "Profile gfm-literal-table-v1; ASCII @ is rejected; every other CommonMark ASCII punctuation character is backslash-escaped",
            "Exact rectangular dimensions, explicit left/center/right alignment and final LF",
            "Empty cells and duplicate headers remain strings, without implicit object conversion",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "gfm-literal-table-v1",
            "columns": 20,
            "rows": 100,
            "cellScalars": 200,
            "aggregateCellBytes": 20000,
            "atSign": "rejected to prevent unavoidable GFM email autolinking",
            "renderedSpaces": "browser layout may collapse repeated spaces"
          },
          "related": [
            "markdown-table-extract",
            "csv-serialize",
            "record-relations"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "TABLE_SHAPE",
            "CELL_AUTOLINK",
            "CELL_LIMIT",
            "CELL_CONTROL",
            "CELL_WHITESPACE",
            "TABLE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "headers": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 400,
                      "description": "Literal GFM cell: at most 200 Unicode scalars; no controls, leading/trailing ASCII spaces or ASCII @ (email autolinking cannot otherwise be suppressed)."
                    }
                  },
                  "align": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "left",
                        "center",
                        "right"
                      ]
                    }
                  },
                  "rows": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 20,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "maxLength": 400,
                        "description": "Literal GFM cell: at most 200 Unicode scalars; no controls, leading/trailing ASCII spaces or ASCII @ (email autolinking cannot otherwise be suppressed)."
                      }
                    }
                  }
                },
                "required": [
                  "headers",
                  "align",
                  "rows"
                ],
                "additionalProperties": false
              },
              "example": {
                "headers": [
                  "Name",
                  "Note"
                ],
                "align": [
                  "left",
                  "right"
                ],
                "rows": [
                  [
                    "A|B",
                    "<b>"
                  ]
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "gfm-table-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "markdown": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "rowCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100
                        },
                        "columnCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 20
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 50000
                        }
                      },
                      "required": [
                        "markdown",
                        "rowCount",
                        "columnCount",
                        "byteLength"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "gfm-table-compose",
                  "version": "0.29.0",
                  "result": {
                    "markdown": "| Name | Note |\n| :--- | ---: |\n| A\\|B | \\<b\\> |\n",
                    "rowCount": 1,
                    "columnCount": 2,
                    "byteLength": 49
                  },
                  "provenance": {
                    "inputSha256": "bd997c57f922649cb03ae151e68001c13b51aab9d7837893267028102ddd8e84",
                    "outputSha256": "371771ed09a9e61e0fb6a7bf77671979eefd5af875495834ddcd0608ef42c070",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/qr-code-compose": {
      "post": {
        "operationId": "x402_qr_code_compose",
        "summary": "Compose an ASCII QR matrix or SVG",
        "description": "Encode 1–64 supplied printable ASCII bytes as a bounded Model 2 QR code using explicit version, error correction and mask; return unbordered module rows or inert black-and-white SVG with a four-module quiet zone.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/qr-code-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate a reproducible QR handoff label from ASCII text",
            "Create a decodable QR SVG or raw module matrix with explicit settings"
          ],
          "whenToUse": [
            "Caller-selected version 1–5, ECC and mask for a short printable ASCII payload"
          ],
          "whenNotToUse": [
            "Opening or judging encoded URLs, verifying destination safety, authenticating payloads or transferring funds",
            "Unicode/ECI, arbitrary binary, automatic segmentation/version/ECC, Kanji, micro-QR, logos, colors or camera/print reliability guarantees",
            "Rendering, printing, writing files, uploading, publishing, or changing remote state",
            "Supplying custom SVG, HTML, CSS, fonts, images, links, scripts or external resources",
            "Guaranteeing font appearance, printer alignment, source authenticity or accessibility compliance"
          ],
          "capabilities": [
            "Pinned maintained qr@0.7.2 byte-mode encoder, no handwritten QR engine",
            "Independent synthetic ZXing decoder verification; deterministic module matrix and original escaped SVG serialization",
            "Escaped literal text in an original fixed inert SVG serializer",
            "Deterministic supplied-input-only artifact with no network, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "qr-model2-ascii-byte-v1",
            "payloadAsciiBytes": 64,
            "minimumVersion": 1,
            "maximumVersion": 5,
            "maximumModuleCount": 37,
            "quietZoneModules": 4,
            "maximumProjectedResultBytes": 20000
          },
          "related": [
            "label-sheet-compose",
            "svg-bar-chart-compose",
            "url-inspect"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "CAPACITY_EXCEEDED",
            "ENCODER_FAILURE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64,
                    "pattern": "^[\\x20-\\x7e]+$"
                  },
                  "version": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 5
                  },
                  "errorCorrection": {
                    "type": "string",
                    "enum": [
                      "L",
                      "M",
                      "Q",
                      "H"
                    ]
                  },
                  "mask": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 7
                  },
                  "output": {
                    "type": "string",
                    "enum": [
                      "matrix",
                      "svg"
                    ]
                  }
                },
                "required": [
                  "text",
                  "version",
                  "errorCorrection",
                  "mask",
                  "output"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "A",
                "version": 1,
                "errorCorrection": "M",
                "mask": 0,
                "output": "matrix"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "qr-code-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "mode": {
                              "type": "string",
                              "const": "byte"
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 5
                            },
                            "errorCorrection": {
                              "type": "string",
                              "enum": [
                                "L",
                                "M",
                                "Q",
                                "H"
                              ]
                            },
                            "mask": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 7
                            },
                            "moduleCount": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "const": 21
                                },
                                {
                                  "type": "number",
                                  "const": 25
                                },
                                {
                                  "type": "number",
                                  "const": 29
                                },
                                {
                                  "type": "number",
                                  "const": 33
                                },
                                {
                                  "type": "number",
                                  "const": 37
                                }
                              ]
                            },
                            "quietZone": {
                              "type": "number",
                              "const": 4
                            },
                            "matrix": {
                              "minItems": 21,
                              "maxItems": 37,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[01]{21,37}$"
                              }
                            }
                          },
                          "required": [
                            "mode",
                            "version",
                            "errorCorrection",
                            "mask",
                            "moduleCount",
                            "quietZone",
                            "matrix"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "mode": {
                              "type": "string",
                              "const": "byte"
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 5
                            },
                            "errorCorrection": {
                              "type": "string",
                              "enum": [
                                "L",
                                "M",
                                "Q",
                                "H"
                              ]
                            },
                            "mask": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 7
                            },
                            "moduleCount": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "const": 21
                                },
                                {
                                  "type": "number",
                                  "const": 25
                                },
                                {
                                  "type": "number",
                                  "const": 29
                                },
                                {
                                  "type": "number",
                                  "const": 33
                                },
                                {
                                  "type": "number",
                                  "const": 37
                                }
                              ]
                            },
                            "quietZone": {
                              "type": "number",
                              "const": 4
                            },
                            "svg": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "mode",
                            "version",
                            "errorCorrection",
                            "mask",
                            "moduleCount",
                            "quietZone",
                            "svg"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "qr-code-compose",
                  "version": "0.29.0",
                  "result": {
                    "mode": "byte",
                    "version": 1,
                    "errorCorrection": "M",
                    "mask": 0,
                    "moduleCount": 21,
                    "quietZone": 4,
                    "matrix": [
                      "111111100111001111111",
                      "100000101011101000001",
                      "101110100010001011101",
                      "101110100100001011101",
                      "101110101100101011101",
                      "100000100010101000001",
                      "111111101010101111111",
                      "000000000001100000000",
                      "101010100011000010010",
                      "100111000100001000110",
                      "010000101110100010001",
                      "101010000110001000100",
                      "101001101010101010101",
                      "000000001111010101010",
                      "111111100001011101111",
                      "100000100101110111000",
                      "101110101101011101101",
                      "101110100000001000110",
                      "101110101100100010001",
                      "100000100110001000110",
                      "111111101000101010111"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "22c0c673c1ebd25bc94fdf4bd3a38024646b8f8d3ff9eb2bb358a9624bdf9d12",
                    "outputSha256": "89e8b2d4b7d5671b44b869934c159f4c635f627316c8f5cc8ef089d71ac07a28",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/zip-store-compose": {
      "post": {
        "operationId": "x402_zip_store_compose",
        "summary": "Reproducible portable ZIP STORE composer",
        "description": "WHEN TO USE: Package 1–32 supplied files as exact deterministic ZIP STORE bytes, CRC32, SHA-256 and member offsets for ZIP consumers. Restricted portable ASCII paths, fixed metadata, no compression, extraction, ZIP64, encryption, links or executable permissions. Does not create office-document formats or guarantee safe consumer extraction.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/zip-store-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Package supplied files as a reproducible uncompressed ZIP archive",
            "Create a ZIP container for a consumer that does not accept TAR"
          ],
          "whenToUse": [
            "Need exact classic ZIP STORE bytes from explicit named file data"
          ],
          "whenNotToUse": [
            "Reading or extracting ZIP, compression, encryption, signing, ZIP64 or filesystem paths",
            "Creating DOCX, XLSX or EPUB semantic package formats",
            "Extracting archives, writing files, uploading, publishing, or changing external state"
          ],
          "capabilities": [
            "Profile portable-store-zip-v1; exact ASCII path ordering, no name or ancestor collisions",
            "Fixed DOS 1980-01-01 00:00:00, creator 0, versions 10, flags 0 and archive attribute 0x20",
            "CRC32 and SHA-256 of each payload plus archive SHA-256; integrity is not authenticity",
            "Deterministic supplied-input-only bytes; no network, clock, randomness or decompression"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "portable-store-zip-v1",
            "files": 32,
            "pathBytes": 100,
            "segmentBytes": 64,
            "payloadBytes": 60000,
            "archiveBytes": 68854
          },
          "related": [
            "ustar-bundle-compose",
            "content-digest",
            "multipart-form-encode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "INVALID_PATH",
            "DUPLICATE_PATH",
            "PATH_COLLISION",
            "ARCHIVE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "files": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 80000
                        }
                      },
                      "required": [
                        "path",
                        "encoding",
                        "data"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "files"
                ],
                "additionalProperties": false
              },
              "example": {
                "files": [
                  {
                    "path": "a.txt",
                    "encoding": "utf8",
                    "data": "hi\n"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "zip-store-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "encoding": {
                          "type": "string",
                          "const": "base64"
                        },
                        "archive": {
                          "type": "string",
                          "maxLength": 91808
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 100,
                          "maximum": 68854
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "manifest": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 31
                              },
                              "path": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "byteLength": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "crc32": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{8}$"
                              },
                              "sha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "headerOffset": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 68854
                              },
                              "dataOffset": {
                                "type": "integer",
                                "minimum": 31,
                                "maximum": 68854
                              }
                            },
                            "required": [
                              "inputIndex",
                              "path",
                              "byteLength",
                              "crc32",
                              "sha256",
                              "headerOffset",
                              "dataOffset"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "encoding",
                        "archive",
                        "byteLength",
                        "sha256",
                        "manifest"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "zip-store-compose",
                  "version": "0.29.0",
                  "result": {
                    "encoding": "base64",
                    "archive": "UEsDBAoAAAAAAAAAIQB6em/tAwAAAAMAAAAFAAAAYS50eHRoaQpQSwECCgAKAAAAAAAAACEAenpv7QMAAAADAAAABQAAAAAAAAAAACAAAAAAAAAAYS50eHRQSwUGAAAAAAEAAQAzAAAAJgAAAAAA",
                    "byteLength": 111,
                    "sha256": "e234d8c82aedfe28cb160a03f2862eb4737208ffb98f7695f69b4638b880a625",
                    "manifest": [
                      {
                        "inputIndex": 0,
                        "path": "a.txt",
                        "byteLength": 3,
                        "crc32": "ed6f7a7a",
                        "sha256": "98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4",
                        "headerOffset": 0,
                        "dataOffset": 35
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "466d72e01f0ff4307aa75b44e6b6878bb3d1a57ccf05469a06d81e78042cef93",
                    "outputSha256": "99ba12cd80aea4a9952cbbad1e4da78c8e6b25d504f525006f6cc04a3159502f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/text-bytes-transcode": {
      "post": {
        "operationId": "x402_text_bytes_transcode",
        "summary": "Strict explicit Unicode and Latin1 byte transcoder",
        "description": "WHEN TO USE: Convert caller-supplied Base64 text-file bytes between explicit UTF-8, UTF-16LE, UTF-16BE and reversible Latin1 byte mapping with strict BOM rules. Rejects malformed sequences and unrepresentable scalars without replacements. No charset detection, Windows-1252 aliases, normalization, newline conversion or plaintext echo.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-bytes-transcode.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Convert supplied file bytes to an explicitly declared importer encoding",
            "Strictly transcode UTF-8 UTF-16 and true Latin1 byte-map data"
          ],
          "whenToUse": [
            "Know both source and target encoding and explicit initial-BOM policy"
          ],
          "whenNotToUse": [
            "Guessing encodings, repairing mojibake, lossy replacement, newline conversion or Unicode normalization",
            "Windows-1252, ASCII aliases, ISO-8859-1 WHATWG label handling or arbitrary legacy code pages",
            "Blind transcoding of fixed byte-column files whose layout depends on original encoding",
            "Extracting archives, writing files, uploading, publishing, or changing external state"
          ],
          "capabilities": [
            "Profile strict-unicode-latin1-bytes-v1; byte N maps exactly to U+00NN including 0x80–0x9F",
            "Remove at most one declared initial BOM; preserve subsequent U+FEFF; opposite UTF-16 BOM rejected",
            "Strict scalar validation and exact target-size preflight before output allocation",
            "Deterministic supplied-input-only bytes; no network, clock, randomness or decompression"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "strict-unicode-latin1-bytes-v1",
            "decodedInputBytes": 60000,
            "scalars": 60000,
            "encodedOutputBytes": 120003
          },
          "related": [
            "base64-convert",
            "blob-decode",
            "multipart-form-encode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "BOM_POLICY",
            "BOM_MISMATCH",
            "BOM_FORBIDDEN",
            "BOM_REQUIRED",
            "INVALID_TEXT_BYTES",
            "SCALAR_LIMIT",
            "UNREPRESENTABLE_SCALAR",
            "TEXT_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "data": {
                    "type": "string",
                    "maxLength": 80000
                  },
                  "from": {
                    "type": "string",
                    "enum": [
                      "utf8",
                      "utf16le",
                      "utf16be",
                      "latin1-byte-map"
                    ]
                  },
                  "to": {
                    "type": "string",
                    "enum": [
                      "utf8",
                      "utf16le",
                      "utf16be",
                      "latin1-byte-map"
                    ]
                  },
                  "inputBom": {
                    "type": "string",
                    "enum": [
                      "forbid",
                      "strip-if-present",
                      "require"
                    ]
                  },
                  "outputBom": {
                    "type": "string",
                    "enum": [
                      "omit",
                      "add"
                    ]
                  }
                },
                "required": [
                  "data",
                  "from",
                  "to",
                  "inputBom",
                  "outputBom"
                ],
                "additionalProperties": false
              },
              "example": {
                "data": "Q2Fm6Q==",
                "from": "latin1-byte-map",
                "to": "utf16le",
                "inputBom": "forbid",
                "outputBom": "add"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-bytes-transcode",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "encoding": {
                          "type": "string",
                          "const": "base64"
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 160004
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 120003
                        },
                        "scalarCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 60000
                        },
                        "inputBomRemoved": {
                          "type": "boolean"
                        },
                        "outputBomAdded": {
                          "type": "boolean"
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        }
                      },
                      "required": [
                        "encoding",
                        "data",
                        "byteLength",
                        "scalarCount",
                        "inputBomRemoved",
                        "outputBomAdded",
                        "sha256"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-bytes-transcode",
                  "version": "0.29.0",
                  "result": {
                    "encoding": "base64",
                    "data": "//5DAGEAZgDpAA==",
                    "byteLength": 10,
                    "scalarCount": 4,
                    "inputBomRemoved": false,
                    "outputBomAdded": true,
                    "sha256": "01a70ae1886925565f6859a2bf3ec11488db5153aed684cbaec5f3873c0a2a86"
                  },
                  "provenance": {
                    "inputSha256": "04a6037740625343feb9dfbc365b5bc359eb05c2228270e4b740539df50ee265",
                    "outputSha256": "82b19e8ba47311b957cb023deefd906f4c8f2f4a6727ce1427b32da3f2ea0a3b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/png-selected-chunks-remove": {
      "post": {
        "operationId": "x402_png_selected_chunks_remove",
        "summary": "PNG framed selected-chunk removal",
        "description": "WHEN TO USE: Remove every PNG chunk of explicitly selected tEXt, zTXt, iTXt, eXIf or tIME types while retaining other bytes exactly. Checks CRC/framing and restricted static 8-bit RGB/RGBA headers only. Does not decode IDAT, guarantee valid images, sanitize all metadata, anonymize pixels or guarantee unchanged visual interpretation; EXIF removal may change orientation.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/png-selected-chunks-remove.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Remove explicitly selected PNG text EXIF or time chunks from supplied bytes",
            "Keep PNG critical and unselected ancillary byte ranges unchanged while deleting selected chunk types"
          ],
          "whenToUse": [
            "Need bounded chunk-type removal under a container-framing-only guarantee"
          ],
          "whenNotToUse": [
            "Complete metadata scrubbing, privacy sanitization, anonymization, valid-image certification or guaranteed visual equivalence",
            "JPEG, WebP, HEIC, TIFF, palettes, transparency keys, APNG, interlacing or unsupported PNG headers",
            "Decoding pixels, validating compressed image data, decompressing embedded text or parsing EXIF/ICC semantics",
            "Extracting archives, writing files, uploading, publishing, or changing external state"
          ],
          "capabilities": [
            "Profile png-framed-selected-removal-v1; verify signature, CRCs, first IHDR, contiguous nonempty IDAT and terminal IEND",
            "Retain unselected chunks byte-for-byte and in order; removed audit contains types and offsets only",
            "Unselected ancillary chunks and visible pixels may still carry identifying information; EXIF removal can change interpretation",
            "Deterministic supplied-input-only bytes; no network, clock, randomness or decompression"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "png-framed-selected-removal-v1",
            "decodedInputBytes": 60000,
            "outputPngBytes": 60000,
            "chunks": 128,
            "dimension": 4096,
            "pixels": 1000000,
            "verification": "container-framing-only"
          },
          "related": [
            "content-digest",
            "base64-convert",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "DUPLICATE_SELECTION",
            "PNG_SIGNATURE",
            "PNG_CHUNK_LIMIT",
            "PNG_LENGTH",
            "PNG_CHUNK_TYPE",
            "PNG_CRC",
            "PNG_STRUCTURE",
            "PNG_DIMENSIONS",
            "PNG_PROFILE",
            "PNG_CRITICAL_CHUNK"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "data": {
                    "type": "string",
                    "maxLength": 80000
                  },
                  "remove": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "tEXt",
                        "zTXt",
                        "iTXt",
                        "eXIf",
                        "tIME"
                      ]
                    }
                  }
                },
                "required": [
                  "data",
                  "remove"
                ],
                "additionalProperties": false
              },
              "example": {
                "data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADHRFWHRDb21tZW50AGRlbW9ZXIpFAAAADUlEQVR4nGP4z8DwHwAFAAH/iZk9HQAAAABJRU5ErkJggg==",
                "remove": [
                  "tEXt"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "png-selected-chunks-remove",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "encoding": {
                          "type": "string",
                          "const": "base64"
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 80000
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 58,
                          "maximum": 60000
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "width": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 4096
                        },
                        "height": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 4096
                        },
                        "removed": {
                          "maxItems": 125,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "tEXt",
                                  "zTXt",
                                  "iTXt",
                                  "eXIf",
                                  "tIME"
                                ]
                              },
                              "sourceOffset": {
                                "type": "integer",
                                "minimum": 33,
                                "maximum": 60000
                              },
                              "totalBytes": {
                                "type": "integer",
                                "minimum": 12,
                                "maximum": 60000
                              }
                            },
                            "required": [
                              "type",
                              "sourceOffset",
                              "totalBytes"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "preservedChunkTypes": {
                          "minItems": 3,
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z]{2}[A-Z][A-Za-z]$"
                          }
                        },
                        "verification": {
                          "type": "string",
                          "const": "container-framing-only"
                        }
                      },
                      "required": [
                        "encoding",
                        "data",
                        "byteLength",
                        "sha256",
                        "width",
                        "height",
                        "removed",
                        "preservedChunkTypes",
                        "verification"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "png-selected-chunks-remove",
                  "version": "0.29.0",
                  "result": {
                    "encoding": "base64",
                    "data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR4nGP4z8DwHwAFAAH/iZk9HQAAAABJRU5ErkJggg==",
                    "byteLength": 70,
                    "sha256": "4ff6ab670a58c14270e034e2090d9a432caa263a14e0a25785386b0c12f880b5",
                    "width": 1,
                    "height": 1,
                    "removed": [
                      {
                        "type": "tEXt",
                        "sourceOffset": 33,
                        "totalBytes": 24
                      }
                    ],
                    "preservedChunkTypes": [
                      "IHDR",
                      "IDAT",
                      "IEND"
                    ],
                    "verification": "container-framing-only"
                  },
                  "provenance": {
                    "inputSha256": "09b3ae4c431b95bf33334003b3f845cff861c7293f847ce387a817a712dca39e",
                    "outputSha256": "caf9779a8f3189de0fce9ec48e84febb02f0e359afa43910849af830f16df88c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/captions-retime-convert": {
      "post": {
        "operationId": "x402_captions_retime_convert",
        "summary": "Retime and convert literal captions",
        "description": "Convert a strict plain SRT/WebVTT caption file with caller-supplied rational time scaling and offset, returning canonical caption text and an exact cue timing map.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/captions-retime-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Convert supplied plain SRT subtitles to WebVTT or WebVTT to SRT",
            "Shift subtitle cue times by a known offset or correct constant drift using explicit rational scaling"
          ],
          "whenToUse": [
            "Supplied literal caption text with explicit hour timestamps and a known affine millisecond transform"
          ],
          "whenNotToUse": [
            "Transcription, translation, speaker identification, media access, inferred sync anchors or guaranteed audiovisual alignment",
            "Rich captions, markup, entities, whitespace-only cue lines, cue settings, STYLE, REGION, NOTE or arbitrary WebVTT identifiers",
            "Fetching, uploading, sending, writing files, accessing media or changing external state"
          ],
          "capabilities": [
            "Exact BigInt rational endpoint transformation with one nearest-ties-even millisecond rounding",
            "Canonical LF timestamps and cue indexes, preserved literal text and source/output timing map",
            "Atomic rejection of unsupported grammar, unordered starts, range violations or collapsed durations",
            "Deterministic supplied-input-only inert artifact with no network, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "literal-captions-affine-ms-v1",
            "sourceBytes": 60000,
            "cues": 1000,
            "totalCueTextBytes": 40000,
            "linesPerCue": 20,
            "captionOutputBytes": 100000,
            "maximumTimeMs": 359999999,
            "maximumScalePart": 1000000,
            "scaleRange": "1/1000 through 1000",
            "webvttIds": "all absent or all contiguous numeric 1..N"
          },
          "related": [
            "text-bytes-transcode",
            "zip-store-compose",
            "timestamp-convert"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "CAPTION_SOURCE_LIMIT",
            "CAPTION_SCALE_RANGE",
            "CAPTION_SYNTAX",
            "CAPTION_TEXT_PROFILE",
            "CAPTION_CUE_LIMIT",
            "CAPTION_DURATION",
            "CAPTION_ORDER",
            "CAPTION_TEXT_LIMIT",
            "CAPTION_TIME_RANGE",
            "CAPTION_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "from": {
                    "type": "string",
                    "enum": [
                      "srt",
                      "webvtt"
                    ]
                  },
                  "to": {
                    "type": "string",
                    "enum": [
                      "srt",
                      "webvtt"
                    ]
                  },
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 60000
                  },
                  "timing": {
                    "type": "object",
                    "properties": {
                      "scaleNumerator": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      },
                      "scaleDenominator": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      },
                      "offsetMs": {
                        "type": "integer",
                        "minimum": -359999999,
                        "maximum": 359999999
                      }
                    },
                    "required": [
                      "scaleNumerator",
                      "scaleDenominator",
                      "offsetMs"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "from",
                  "to",
                  "text",
                  "timing"
                ],
                "additionalProperties": false
              },
              "example": {
                "from": "srt",
                "to": "webvtt",
                "text": "1\n00:00:01,000 --> 00:00:02,500\nHello\n\n",
                "timing": {
                  "scaleNumerator": 1,
                  "scaleDenominator": 1,
                  "offsetMs": 250
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "captions-retime-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "format": {
                          "type": "string",
                          "enum": [
                            "srt",
                            "webvtt"
                          ]
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100000
                        },
                        "cues": {
                          "minItems": 1,
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 999
                              },
                              "startMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 359999999
                              },
                              "endMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 359999999
                              },
                              "sourceStartMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 359999999
                              },
                              "sourceEndMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 359999999
                              }
                            },
                            "required": [
                              "inputIndex",
                              "startMs",
                              "endMs",
                              "sourceStartMs",
                              "sourceEndMs"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "rounding": {
                          "type": "string",
                          "const": "nearest-ties-even"
                        }
                      },
                      "required": [
                        "format",
                        "text",
                        "byteLength",
                        "cues",
                        "rounding"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "captions-retime-convert",
                  "version": "0.29.0",
                  "result": {
                    "format": "webvtt",
                    "text": "WEBVTT\n\n1\n00:00:01.250 --> 00:00:02.750\nHello\n\n",
                    "byteLength": 47,
                    "cues": [
                      {
                        "inputIndex": 0,
                        "startMs": 1250,
                        "endMs": 2750,
                        "sourceStartMs": 1000,
                        "sourceEndMs": 2500
                      }
                    ],
                    "rounding": "nearest-ties-even"
                  },
                  "provenance": {
                    "inputSha256": "86618830933272d3a6509644a192dbec754392cc7a3882ed00cd19de4dc7ce88",
                    "outputSha256": "9963ea0da9e0b915bf16503d12e7c6db4c9cc690b3ec6d64f95b28f9ccc5a2cc",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/fixed-width-records-compose": {
      "post": {
        "operationId": "x402_fixed_width_records_compose",
        "summary": "Compose UTF-8 byte-column records",
        "description": "Write a real fixed-width UTF-8 import artifact from caller-declared byte columns and string records, with explicit ASCII padding, strict overflow rejection and byte offset manifest.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/fixed-width-records-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Create fixed-width UTF-8 record files with exact byte column positions",
            "Pad string fields to supplied byte widths for a fixed-width importer"
          ],
          "whenToUse": [
            "Explicit UTF-8 byte column layout, ASCII pad characters and exact-key string records"
          ],
          "whenNotToUse": [
            "Terminal display width, glyph alignment, packed decimals, spreadsheet formatting or named bank/government formats",
            "Truncation, numeric coercion, parsing fixed-width input or CSV comparison",
            "Blind transcoding after layout; changing encoding can invalidate UTF-8 byte widths",
            "Fetching, uploading, sending, writing files, accessing media or changing external state"
          ],
          "capabilities": [
            "Exact UTF-8 byte widths, caller-selected left/right ASCII padding and LF/CRLF framing",
            "Ordered records and columns, zero-based end-exclusive per-record column offsets and row byte offsets",
            "Atomic rejection of overflow or mismatched row keys without truncation",
            "Deterministic supplied-input-only inert artifact with no network, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "utf8-byte-column-records-v1",
            "encoding": "UTF-8",
            "columns": 32,
            "maximumColumnBytes": 256,
            "maximumRecordBytes": 4096,
            "rows": 1000,
            "textOutputBytes": 100000
          },
          "related": [
            "csv-serialize",
            "template-render",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "RECORD_COLUMN_NAME",
            "RECORD_DUPLICATE_COLUMN",
            "RECORD_WIDTH_LIMIT",
            "RECORD_OUTPUT_LIMIT",
            "RECORD_ROW_KEYS",
            "RECORD_TEXT_PROFILE",
            "RECORD_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "columns": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "widthBytes": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 256
                        },
                        "align": {
                          "type": "string",
                          "enum": [
                            "left",
                            "right"
                          ]
                        },
                        "pad": {
                          "type": "string",
                          "pattern": "^[\\x20-\\x7e]$"
                        }
                      },
                      "required": [
                        "name",
                        "widthBytes",
                        "align",
                        "pad"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "rows": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string"
                      }
                    }
                  },
                  "lineEnding": {
                    "type": "string",
                    "enum": [
                      "LF",
                      "CRLF"
                    ]
                  },
                  "finalLineEnding": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "columns",
                  "rows",
                  "lineEnding",
                  "finalLineEnding"
                ],
                "additionalProperties": false
              },
              "example": {
                "columns": [
                  {
                    "name": "code",
                    "widthBytes": 4,
                    "align": "left",
                    "pad": " "
                  },
                  {
                    "name": "qty",
                    "widthBytes": 4,
                    "align": "right",
                    "pad": "0"
                  }
                ],
                "rows": [
                  {
                    "code": "A",
                    "qty": "7"
                  },
                  {
                    "code": "BB",
                    "qty": "42"
                  }
                ],
                "lineEnding": "CRLF",
                "finalLineEnding": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "fixed-width-records-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "recordByteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 4096
                        },
                        "rowByteOffsets": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 100000
                          }
                        },
                        "columns": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              "startByte": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 4095
                              },
                              "endByte": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 4096
                              }
                            },
                            "required": [
                              "name",
                              "startByte",
                              "endByte"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "text",
                        "byteLength",
                        "recordByteLength",
                        "rowByteOffsets",
                        "columns"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "fixed-width-records-compose",
                  "version": "0.29.0",
                  "result": {
                    "text": "A   0007\r\nBB  0042\r\n",
                    "byteLength": 20,
                    "recordByteLength": 8,
                    "rowByteOffsets": [
                      0,
                      10
                    ],
                    "columns": [
                      {
                        "name": "code",
                        "startByte": 0,
                        "endByte": 4
                      },
                      {
                        "name": "qty",
                        "startByte": 4,
                        "endByte": 8
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "6c94e72ed91c6ffdc231e1e577a82ffbc281de0948cc75ebd270a8517d1caa47",
                    "outputSha256": "7f21c0e660c167d123da9877752f336c268d2984b2657754946d028cc92b45a4",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-selector-redact": {
      "post": {
        "operationId": "x402_json_selector_redact",
        "summary": "Explicit structural JSON redaction",
        "description": "Remove object members or replace selected JSON subtrees with caller-supplied scalars using bounded typed selectors. Original-snapshot matching, expected-count guards and overlap rejection make edits atomic. Optional audit omission; no secret discovery, PII inference, anonymization or safe-to-share guarantee.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-selector-redact.md"
        },
        "x-agent-discovery": {
          "intents": [
            "redact explicit JSON fields across repeated records",
            "remove selected object members with expected match counts",
            "replace structured JSON subtrees with explicit scalar placeholders"
          ],
          "whenToUse": [
            "Caller knows which structural fields must be removed or replaced",
            "Guard a repeated-record cleanup with exact match counts and simultaneous edits"
          ],
          "whenNotToUse": [
            "Discover secrets or infer personal information from meaning",
            "Guarantee anonymity or that remaining data is safe to share",
            "Apply arbitrary JSONPath, regex, recursive descent or scripts",
            "Remove array elements or reorder their identity",
            "Known exact-pointer edits already fit JSON Patch",
            "Read files, send documents, fetch data or change external state"
          ],
          "capabilities": [
            "Declared profile: explicit-structural-redaction-v1",
            "Typed key/index/anyKey/anyIndex selectors with exact own-property matching",
            "Resolve against the original snapshot, guard match counts, reject duplicate and ancestor targets, then clone",
            "Audit contains only caller rule IDs, escaped JSON Pointer paths, action names and counts; includeAudit=false omits both audit and counts",
            "Audit paths/counts and the retained document can expose sensitive structure; callers control replacement values",
            "Deterministic input-only result; no network, clock, randomness, filesystem or runtime dependencies"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "rules": 64,
            "selectorTokens": 20,
            "selectedTargets": 2000,
            "selectorVisits": 250000,
            "profile": "explicit-structural-redaction-v1",
            "ruleIdScalars": 64,
            "selectorIndexMaximum": 9007199254740991
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "DUPLICATE_RULE_ID",
            "INVALID_MATCH_BOUNDS",
            "SELECTOR_VISIT_LIMIT",
            "MATCH_COUNT",
            "TARGET_LIMIT",
            "INVALID_REMOVE_TARGET",
            "TARGET_CONFLICT"
          ],
          "related": [
            "json-patch",
            "pii-redact",
            "json-batch-encode"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1x402~1json-selector-redact/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "rules": {
                    "minItems": 1,
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[\\s\\S]{1,64}(?![\\s\\S])"
                        },
                        "select": {
                          "maxItems": 20,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "key": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "key"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "index": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                },
                                "required": [
                                  "index"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "anyKey": {
                                    "type": "boolean",
                                    "const": true
                                  }
                                },
                                "required": [
                                  "anyKey"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "anyIndex": {
                                    "type": "boolean",
                                    "const": true
                                  }
                                },
                                "required": [
                                  "anyIndex"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        },
                        "action": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "replace"
                                },
                                "value": {
                                  "type": [
                                    "string",
                                    "number",
                                    "boolean",
                                    "null"
                                  ]
                                }
                              },
                              "required": [
                                "type",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "remove"
                                }
                              },
                              "required": [
                                "type"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "minMatches": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2000
                        },
                        "maxMatches": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2000
                        }
                      },
                      "required": [
                        "id",
                        "select",
                        "action",
                        "minMatches",
                        "maxMatches"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "includeAudit": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "document",
                  "rules"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-selector-redact/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-selector-redact/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "users": [
                    {
                      "email": "a@example.invalid",
                      "name": "A"
                    },
                    {
                      "email": "b@example.invalid",
                      "name": "B"
                    }
                  ]
                },
                "rules": [
                  {
                    "id": "email",
                    "select": [
                      {
                        "key": "users"
                      },
                      {
                        "anyIndex": true
                      },
                      {
                        "key": "email"
                      }
                    ],
                    "action": {
                      "type": "replace",
                      "value": "[REDACTED]"
                    },
                    "minMatches": 2,
                    "maxMatches": 2
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-selector-redact",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "document": {
                              "$ref": "#/paths/~1v1~1x402~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            }
                          },
                          "required": [
                            "document"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "document": {
                              "$ref": "#/paths/~1v1~1x402~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema1"
                            },
                            "audit": {
                              "maxItems": 2000,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "ruleId": {
                                    "type": "string"
                                  },
                                  "path": {
                                    "type": "string"
                                  },
                                  "action": {
                                    "type": "string",
                                    "enum": [
                                      "replace",
                                      "remove"
                                    ]
                                  }
                                },
                                "required": [
                                  "ruleId",
                                  "path",
                                  "action"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "counts": {
                              "minItems": 1,
                              "maxItems": 64,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "ruleId": {
                                    "type": "string"
                                  },
                                  "matches": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 2000
                                  }
                                },
                                "required": [
                                  "ruleId",
                                  "matches"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "document",
                            "audit",
                            "counts"
                          ],
                          "additionalProperties": false
                        }
                      ],
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        },
                        "__schema1": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema1"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema1"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-selector-redact",
                  "version": "0.29.0",
                  "result": {
                    "document": {
                      "users": [
                        {
                          "email": "[REDACTED]",
                          "name": "A"
                        },
                        {
                          "email": "[REDACTED]",
                          "name": "B"
                        }
                      ]
                    },
                    "audit": [
                      {
                        "ruleId": "email",
                        "path": "/users/0/email",
                        "action": "replace"
                      },
                      {
                        "ruleId": "email",
                        "path": "/users/1/email",
                        "action": "replace"
                      }
                    ],
                    "counts": [
                      {
                        "ruleId": "email",
                        "matches": 2
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "c13cf62b63cbaafe9d7c6aa847143adc63520cd1abf7abf76ac9b552aa4de723",
                    "outputSha256": "3cb2f0624e5a91719650e702ddc997419a88216846b14e80be844bb1119eb33c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/records-map-transform": {
      "post": {
        "operationId": "x402_records_map_transform",
        "summary": "Nested record mapping with guarded patches",
        "description": "Construct nested destination records from explicit copy, literal and exact-string lookup rules. Return bounded provenance and optional root-test-guarded RFC 6902 patches. Object destinations only; no implicit coercion, expressions, array expansion, writes or source authenticity checks.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-map-transform.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Adapt records into a nested import schema with provenance",
            "Generate guarded reviewable record migration patches"
          ],
          "whenToUse": [
            "Map supplied records to nested object destinations using a bounded declarative mapping"
          ],
          "whenNotToUse": [
            "Flat field selection only; use records-project",
            "General expressions, recursive array mapping, joins, coercion or redaction",
            "Executing code, writing files, environment changes, network requests, publishing or deployment"
          ],
          "capabilities": [
            "Resolve all sources against the original row; no order-sensitive destination overwrite",
            "Numeric destination segments are object names; source arrays require canonical indexes",
            "Missing-null copy uses default disposition and sourcePresent=false; omitted mappings remain in lineage",
            "Patches include the original source row in a root test and do not authorize a write",
            "Patch modes also pass the released json-patch consumer, including every intermediate-state size/depth/container limit",
            "Aggregate mapped destinations and consumer node/character work have explicit pre-challenge budgets",
            "Complete bounded computation before payment challenge and execution; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "records": 128,
            "rules": 32,
            "pointerDepth": 12,
            "pointerUnits": 1024,
            "lookupPairsPerRule": 64,
            "lookupPairsTotal": 512,
            "patchesPerRow": 100,
            "patchesTotal": 2000,
            "projectedDestinationBytes": 400000,
            "destinationJsonNodes": 12000,
            "patchConsumerNodeWork": 50000,
            "patchConsumerCharacterWork": 5000000,
            "patchConsumerContainerEntries": 1000,
            "patchConsumerJsonNodes": 20000,
            "patchConsumerJsonCharacters": 100000,
            "patchConsumerDepth": 32
          },
          "related": [
            "records-project",
            "json-structural-diff",
            "json-patch",
            "json-batch-encode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_POINTER",
            "POINTER_LIMIT",
            "INVALID_ARRAY_INDEX",
            "DUPLICATE_ID",
            "DUPLICATE_LOOKUP_KEY",
            "LOOKUP_LIMIT",
            "DESTINATION_COLLISION",
            "MISSING_SOURCE",
            "LOOKUP_TYPE",
            "UNKNOWN_LOOKUP_KEY",
            "PATCH_LIMIT",
            "PATCH_COMPOSITION",
            "MAPPING_WORK_LIMIT",
            "PATCH_WORK_LIMIT",
            "ITEM_LIMIT",
            "SIZE_LIMIT",
            "DEPTH_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "rules": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "destination": {
                          "type": "string",
                          "maxLength": 1024
                        },
                        "source": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "copy"
                                },
                                "pointer": {
                                  "type": "string",
                                  "maxLength": 1024
                                },
                                "onMissing": {
                                  "type": "string",
                                  "enum": [
                                    "error",
                                    "omit",
                                    "null"
                                  ]
                                }
                              },
                              "required": [
                                "kind",
                                "pointer",
                                "onMissing"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "literal"
                                },
                                "value": {
                                  "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                                }
                              },
                              "required": [
                                "kind",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "lookup"
                                },
                                "pointer": {
                                  "type": "string",
                                  "maxLength": 1024
                                },
                                "pairs": {
                                  "maxItems": 64,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "key": {
                                        "type": "string"
                                      },
                                      "value": {
                                        "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                                      }
                                    },
                                    "required": [
                                      "key",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "onUnknown": {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "error"
                                        }
                                      },
                                      "required": [
                                        "kind"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "default"
                                        },
                                        "value": {
                                          "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "kind",
                                "pointer",
                                "pairs",
                                "onUnknown"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "destination",
                        "source"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "records",
                      "guarded-patches",
                      "both"
                    ]
                  }
                },
                "required": [
                  "records",
                  "rules",
                  "mode"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "id": "c7",
                    "display": "Ada",
                    "tier": "pro"
                  }
                ],
                "rules": [
                  {
                    "id": "id",
                    "destination": "/customer/id",
                    "source": {
                      "kind": "copy",
                      "pointer": "/id",
                      "onMissing": "error"
                    }
                  },
                  {
                    "id": "name",
                    "destination": "/customer/name",
                    "source": {
                      "kind": "copy",
                      "pointer": "/display",
                      "onMissing": "error"
                    }
                  },
                  {
                    "id": "plan",
                    "destination": "/plan",
                    "source": {
                      "kind": "lookup",
                      "pointer": "/tier",
                      "pairs": [
                        {
                          "key": "pro",
                          "value": "paid"
                        }
                      ],
                      "onUnknown": {
                        "kind": "error"
                      }
                    }
                  },
                  {
                    "id": "version",
                    "destination": "/apiVersion",
                    "source": {
                      "kind": "literal",
                      "value": 1
                    }
                  }
                ],
                "mode": "both"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-map-transform",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "nested-record-map-v1"
                        },
                        "mode": {
                          "type": "string",
                          "enum": [
                            "records",
                            "guarded-patches",
                            "both"
                          ]
                        },
                        "rows": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "sourceIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "record": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "provenance": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "ruleId": {
                                      "type": "string"
                                    },
                                    "sourcePointer": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "destinationPointer": {
                                      "type": "string"
                                    },
                                    "sourcePresent": {
                                      "type": [
                                        "boolean",
                                        "null"
                                      ]
                                    },
                                    "disposition": {
                                      "type": "string",
                                      "enum": [
                                        "copied",
                                        "literal",
                                        "lookup",
                                        "default",
                                        "omitted"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "ruleId",
                                    "sourcePointer",
                                    "destinationPointer",
                                    "sourcePresent",
                                    "disposition"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "patch": {
                                "anyOf": [
                                  {
                                    "type": "array",
                                    "items": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "op": {
                                              "type": "string",
                                              "const": "test"
                                            },
                                            "path": {
                                              "type": "string",
                                              "const": ""
                                            },
                                            "value": {
                                              "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                            }
                                          },
                                          "required": [
                                            "op",
                                            "path",
                                            "value"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "op": {
                                              "type": "string",
                                              "const": "add"
                                            },
                                            "path": {
                                              "type": "string",
                                              "maxLength": 1024
                                            },
                                            "value": {
                                              "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                            }
                                          },
                                          "required": [
                                            "op",
                                            "path",
                                            "value"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "op": {
                                              "type": "string",
                                              "const": "replace"
                                            },
                                            "path": {
                                              "type": "string",
                                              "maxLength": 1024
                                            },
                                            "value": {
                                              "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                            }
                                          },
                                          "required": [
                                            "op",
                                            "path",
                                            "value"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "op": {
                                              "type": "string",
                                              "const": "remove"
                                            },
                                            "path": {
                                              "type": "string",
                                              "maxLength": 1024
                                            }
                                          },
                                          "required": [
                                            "op",
                                            "path"
                                          ],
                                          "additionalProperties": false
                                        }
                                      ]
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "sourceIndex",
                              "record",
                              "provenance",
                              "patch"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "recordCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "operationCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "mode",
                        "rows",
                        "recordCount",
                        "operationCount",
                        "externalRequests",
                        "execution"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-map-transform",
                  "version": "0.29.0",
                  "result": {
                    "profile": "nested-record-map-v1",
                    "mode": "both",
                    "rows": [
                      {
                        "sourceIndex": 0,
                        "record": {
                          "apiVersion": 1,
                          "customer": {
                            "id": "c7",
                            "name": "Ada"
                          },
                          "plan": "paid"
                        },
                        "provenance": [
                          {
                            "ruleId": "id",
                            "sourcePointer": "/id",
                            "destinationPointer": "/customer/id",
                            "sourcePresent": true,
                            "disposition": "copied"
                          },
                          {
                            "ruleId": "name",
                            "sourcePointer": "/display",
                            "destinationPointer": "/customer/name",
                            "sourcePresent": true,
                            "disposition": "copied"
                          },
                          {
                            "ruleId": "plan",
                            "sourcePointer": "/tier",
                            "destinationPointer": "/plan",
                            "sourcePresent": true,
                            "disposition": "lookup"
                          },
                          {
                            "ruleId": "version",
                            "sourcePointer": null,
                            "destinationPointer": "/apiVersion",
                            "sourcePresent": null,
                            "disposition": "literal"
                          }
                        ],
                        "patch": [
                          {
                            "op": "test",
                            "path": "",
                            "value": {
                              "display": "Ada",
                              "id": "c7",
                              "tier": "pro"
                            }
                          },
                          {
                            "op": "add",
                            "path": "/apiVersion",
                            "value": 1
                          },
                          {
                            "op": "add",
                            "path": "/customer",
                            "value": {
                              "id": "c7",
                              "name": "Ada"
                            }
                          },
                          {
                            "op": "remove",
                            "path": "/display"
                          },
                          {
                            "op": "remove",
                            "path": "/id"
                          },
                          {
                            "op": "add",
                            "path": "/plan",
                            "value": "paid"
                          },
                          {
                            "op": "remove",
                            "path": "/tier"
                          }
                        ]
                      }
                    ],
                    "recordCount": 1,
                    "operationCount": 7,
                    "externalRequests": 0,
                    "execution": false
                  },
                  "provenance": {
                    "inputSha256": "8a4f0c25859630ea88a6e0300b7add71a1a2bf111d562cb9d5293cc61cd85cff",
                    "outputSha256": "6344421da2c94f9751785c5e99bf3febd7bc3fce3d06070bd5777e2b0d7076ee",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/cost-matrix-round": {
      "post": {
        "operationId": "x402_cost_matrix_round",
        "summary": "Exact two-margin matrix rounding",
        "description": "Round a supplied decimal allocation matrix to exact integer floor/ceiling cells while preserving both declared margins, minimizing absolute error and breaking ties lexicographically; return a verifiable optimum or infeasibility witness. No payments, accounting advice or execution.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/cost-matrix-round.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Round fractional allocations while preserving row and column totals",
            "Reconcile a supplied allocation matrix into integer minor units"
          ],
          "whenToUse": [
            "Caller supplies both exact margins and requires the minimum absolute rounding error"
          ],
          "whenNotToUse": [
            "Actual financial allocation, posting ledgers, payments or accounting advice",
            "Automatically choosing margins or unconstrained proportional apportionment"
          ],
          "capabilities": [
            "Exact decimal BigInt arithmetic with deterministic UTF-16 ID order",
            "Independent residual-potential optimum certificates or bounded infeasibility witnesses",
            "Well-formed infeasible inputs return no usable matrix; pure full evaluation before payment challenge"
          ],
          "related": [
            "integer-apportion",
            "gfm-table-compose"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "rows": 8,
            "columns": 8,
            "cells": 64,
            "decimalIntegerDigits": 18,
            "decimalFractionDigits": 6,
            "targetDigits": 24,
            "vertices": 18,
            "residualArcs": 160,
            "augmentations": 64,
            "maximumRelaxationChecks": 176960
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "MATRIX_DIMENSIONS",
            "MARGIN_TOTAL_MISMATCH",
            "INTERNAL_CERTIFICATE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "rowIds": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  },
                  "columnIds": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  },
                  "values": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 8,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,17})(?:\\.[0-9]{1,6})?$"
                      }
                    }
                  },
                  "rowTargets": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^(?:0|[1-9][0-9]{0,23})$"
                    }
                  },
                  "columnTargets": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^(?:0|[1-9][0-9]{0,23})$"
                    }
                  }
                },
                "required": [
                  "rowIds",
                  "columnIds",
                  "values",
                  "rowTargets",
                  "columnTargets"
                ],
                "additionalProperties": false
              },
              "example": {
                "rowIds": [
                  "r1",
                  "r2"
                ],
                "columnIds": [
                  "a",
                  "b",
                  "c"
                ],
                "values": [
                  [
                    "0.6",
                    "0.6",
                    "0.8"
                  ],
                  [
                    "0.4",
                    "0.4",
                    "0.2"
                  ]
                ],
                "rowTargets": [
                  "2",
                  "1"
                ],
                "columnTargets": [
                  "1",
                  "1",
                  "1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "cost-matrix-round",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "exact-two-margin-round-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "availabilityVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "rowIds": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "columnIds": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "rowTargets": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "columnTargets": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "optimal"
                            },
                            "matrix": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                }
                              }
                            },
                            "rowTotals": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "columnTotals": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "grandTotal": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "absoluteError": {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "pattern": "^[1-9][0-9]*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            "cells": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "floor": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "fraction": {
                                      "type": "object",
                                      "properties": {
                                        "numerator": {
                                          "type": "string",
                                          "pattern": "^(?:0|[1-9][0-9]*)$"
                                        },
                                        "denominator": {
                                          "type": "string",
                                          "pattern": "^[1-9][0-9]*$"
                                        }
                                      },
                                      "required": [
                                        "numerator",
                                        "denominator"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "increment": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1
                                    }
                                  },
                                  "required": [
                                    "floor",
                                    "fraction",
                                    "increment"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "certificate": {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "min-cost-flow-potentials"
                                },
                                "scale": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "primaryMultiplier": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "combinedCost": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "vertexPotentials": {
                                  "minItems": 4,
                                  "maxItems": 18,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                  }
                                },
                                "requiredFlow": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 64
                                },
                                "achievedFlow": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 64
                                }
                              },
                              "required": [
                                "kind",
                                "scale",
                                "primaryMultiplier",
                                "combinedCost",
                                "vertexPotentials",
                                "requiredFlow",
                                "achievedFlow"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "availabilityVerified",
                            "rowIds",
                            "columnIds",
                            "rowTargets",
                            "columnTargets",
                            "status",
                            "matrix",
                            "rowTotals",
                            "columnTotals",
                            "grandTotal",
                            "absoluteError",
                            "cells",
                            "certificate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "exact-two-margin-round-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "availabilityVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "rowIds": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "columnIds": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "rowTargets": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "columnTargets": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "infeasible"
                            },
                            "matrix": {
                              "type": "null"
                            },
                            "witness": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "margin-bound"
                                    },
                                    "axis": {
                                      "type": "string",
                                      "enum": [
                                        "row",
                                        "column"
                                      ]
                                    },
                                    "id": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    "target": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "minimum": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "maximum": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "axis",
                                    "id",
                                    "target",
                                    "minimum",
                                    "maximum"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "residual-min-cut"
                                    },
                                    "reachableRowIds": {
                                      "maxItems": 8,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 100
                                      }
                                    },
                                    "reachableColumnIds": {
                                      "maxItems": 8,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 100
                                      }
                                    },
                                    "requiredFlow": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 64
                                    },
                                    "achievedFlow": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 64
                                    },
                                    "cutCapacity": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 64
                                    },
                                    "partialIncrements": {
                                      "minItems": 1,
                                      "maxItems": 8,
                                      "type": "array",
                                      "items": {
                                        "minItems": 1,
                                        "maxItems": 8,
                                        "type": "array",
                                        "items": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 1
                                        }
                                      }
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "reachableRowIds",
                                    "reachableColumnIds",
                                    "requiredFlow",
                                    "achievedFlow",
                                    "cutCapacity",
                                    "partialIncrements"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "availabilityVerified",
                            "rowIds",
                            "columnIds",
                            "rowTargets",
                            "columnTargets",
                            "status",
                            "matrix",
                            "witness"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "cost-matrix-round",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-two-margin-round-v1",
                    "externalRequests": 0,
                    "execution": false,
                    "availabilityVerified": false,
                    "rowIds": [
                      "r1",
                      "r2"
                    ],
                    "columnIds": [
                      "a",
                      "b",
                      "c"
                    ],
                    "rowTargets": [
                      "2",
                      "1"
                    ],
                    "columnTargets": [
                      "1",
                      "1",
                      "1"
                    ],
                    "status": "optimal",
                    "matrix": [
                      [
                        "0",
                        "1",
                        "1"
                      ],
                      [
                        "1",
                        "0",
                        "0"
                      ]
                    ],
                    "rowTotals": [
                      "2",
                      "1"
                    ],
                    "columnTotals": [
                      "1",
                      "1",
                      "1"
                    ],
                    "grandTotal": "3",
                    "absoluteError": {
                      "numerator": "12",
                      "denominator": "5"
                    },
                    "cells": [
                      [
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "3",
                            "denominator": "5"
                          },
                          "increment": 0
                        },
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "3",
                            "denominator": "5"
                          },
                          "increment": 1
                        },
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "4",
                            "denominator": "5"
                          },
                          "increment": 1
                        }
                      ],
                      [
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "2",
                            "denominator": "5"
                          },
                          "increment": 1
                        },
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "2",
                            "denominator": "5"
                          },
                          "increment": 0
                        },
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "1",
                            "denominator": "5"
                          },
                          "increment": 0
                        }
                      ]
                    ],
                    "certificate": {
                      "kind": "min-cost-flow-potentials",
                      "scale": "10",
                      "primaryMultiplier": "64",
                      "combinedCost": "1564",
                      "vertexPotentials": [
                        "-772",
                        "-530",
                        "-772",
                        "0",
                        "-2",
                        "0",
                        "0"
                      ],
                      "requiredFlow": 3,
                      "achievedFlow": 3
                    }
                  },
                  "provenance": {
                    "inputSha256": "15594a17c74c1a6c9b7cd6f0f74ea731fd6a8c6a10f59eab883541f893d56dfa",
                    "outputSha256": "ac4a933060b7d1d3b3d7d2bb32f7a9a4ef7ba15111ac766bb16a59be2976ee2a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/assignment-cost-optimize": {
      "post": {
        "operationId": "x402_assignment_cost_optimize",
        "summary": "Exact fixed-slot cost assignment",
        "description": "Choose an exact minimum-cost complete one-job-per-slot assignment over caller-declared nonoverlapping slots and admissible edges, with lexical ties and a verifiable optimum or Hall-deficiency certificate. No live availability check, reservation or job dispatch.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/assignment-cost-optimize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Assign independent jobs to fixed slots at minimum total cost",
            "Optimize exact one-to-one job and slot pairing with forbidden assignments"
          ],
          "whenToUse": [
            "Caller declares all admissible edges and pairwise nonoverlapping slots in one time coordinate system"
          ],
          "whenNotToUse": [
            "General precedence or resource scheduling, overlapping slots, travel-time or skill inference",
            "Live calendar availability, slot reservation, real job dispatch, payments or currency conversion"
          ],
          "capabilities": [
            "Exact decimal BigInt optimization with lexical slot-ID ties in sorted job order",
            "Complete assignments and start-ordered inert schedules with residual-potential optimum certificates",
            "Maximum cardinality and a Hall-deficient job-set witness when no complete schedule exists",
            "Pure full evaluation before payment challenge; valid infeasible results contain no usable schedule"
          ],
          "related": [
            "workflow-resource-plan",
            "interval-analyze"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "jobs": 16,
            "slots": 32,
            "edges": 512,
            "tickMaximum": 1000000000000,
            "decimalIntegerDigits": 12,
            "decimalFractionDigits": 6,
            "vertices": 50,
            "residualArcs": 1120,
            "augmentations": 16,
            "maximumVertexSelectionChecks": 40000,
            "maximumEdgeRelaxationChecks": 17920
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "INVALID_SLOT",
            "OVERLAPPING_SLOTS",
            "UNKNOWN_EDGE_ID",
            "DUPLICATE_EDGE",
            "INTERNAL_CERTIFICATE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "jobIds": {
                    "minItems": 1,
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  },
                  "slots": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000000
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000000
                        }
                      },
                      "required": [
                        "id",
                        "start",
                        "end"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "edges": {
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "jobId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "slotId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "cost": {
                          "type": "string",
                          "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                        }
                      },
                      "required": [
                        "jobId",
                        "slotId",
                        "cost"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "timeUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "timeOrigin": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "costUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  }
                },
                "required": [
                  "jobIds",
                  "slots",
                  "edges",
                  "timeUnit",
                  "timeOrigin",
                  "costUnit"
                ],
                "additionalProperties": false
              },
              "example": {
                "jobIds": [
                  "a",
                  "b",
                  "c"
                ],
                "slots": [
                  {
                    "id": "s1",
                    "start": 0,
                    "end": 10
                  },
                  {
                    "id": "s2",
                    "start": 10,
                    "end": 20
                  },
                  {
                    "id": "s3",
                    "start": 20,
                    "end": 30
                  }
                ],
                "edges": [
                  {
                    "jobId": "a",
                    "slotId": "s1",
                    "cost": "7"
                  },
                  {
                    "jobId": "a",
                    "slotId": "s2",
                    "cost": "1"
                  },
                  {
                    "jobId": "a",
                    "slotId": "s3",
                    "cost": "4"
                  },
                  {
                    "jobId": "b",
                    "slotId": "s1",
                    "cost": "2"
                  },
                  {
                    "jobId": "b",
                    "slotId": "s2",
                    "cost": "6"
                  },
                  {
                    "jobId": "b",
                    "slotId": "s3",
                    "cost": "5"
                  },
                  {
                    "jobId": "c",
                    "slotId": "s1",
                    "cost": "3"
                  },
                  {
                    "jobId": "c",
                    "slotId": "s2",
                    "cost": "4"
                  },
                  {
                    "jobId": "c",
                    "slotId": "s3",
                    "cost": "1"
                  }
                ],
                "timeUnit": "minute",
                "timeOrigin": "caller-defined zero",
                "costUnit": "model cost units"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "assignment-cost-optimize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "fixed-slot-exact-assignment-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "availabilityVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "timeUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "timeOrigin": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "costUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "jobIds": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "slotIds": {
                              "minItems": 1,
                              "maxItems": 32,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "optimal"
                            },
                            "assignments": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "jobId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "slotId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "start": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000000000000
                                  },
                                  "end": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000000000000
                                  },
                                  "cost": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                                  }
                                },
                                "required": [
                                  "jobId",
                                  "slotId",
                                  "start",
                                  "end",
                                  "cost"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "schedule": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "jobId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "slotId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "start": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000000000000
                                  },
                                  "end": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000000000000
                                  },
                                  "cost": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                                  }
                                },
                                "required": [
                                  "jobId",
                                  "slotId",
                                  "start",
                                  "end",
                                  "cost"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "unusedSlotIds": {
                              "maxItems": 31,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "totalCost": {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "pattern": "^[1-9][0-9]*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            "certificate": {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "min-cost-flow-potentials"
                                },
                                "scale": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "primaryMultiplier": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "tieBase": {
                                  "type": "integer",
                                  "minimum": 2,
                                  "maximum": 33
                                },
                                "combinedCost": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "vertexPotentials": {
                                  "minItems": 4,
                                  "maxItems": 50,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                  }
                                },
                                "requiredFlow": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 16
                                },
                                "achievedFlow": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 16
                                }
                              },
                              "required": [
                                "kind",
                                "scale",
                                "primaryMultiplier",
                                "tieBase",
                                "combinedCost",
                                "vertexPotentials",
                                "requiredFlow",
                                "achievedFlow"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "availabilityVerified",
                            "timeUnit",
                            "timeOrigin",
                            "costUnit",
                            "jobIds",
                            "slotIds",
                            "status",
                            "assignments",
                            "schedule",
                            "unusedSlotIds",
                            "totalCost",
                            "certificate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "fixed-slot-exact-assignment-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "availabilityVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "timeUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "timeOrigin": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "costUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "jobIds": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "slotIds": {
                              "minItems": 1,
                              "maxItems": 32,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "infeasible"
                            },
                            "schedule": {
                              "type": "null"
                            },
                            "maximumCardinality": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 15
                            },
                            "witness": {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "hall-deficiency"
                                },
                                "jobIds": {
                                  "minItems": 1,
                                  "maxItems": 16,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  }
                                },
                                "neighborSlotIds": {
                                  "maxItems": 32,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  }
                                },
                                "deficiency": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 16
                                },
                                "maximumMatching": {
                                  "maxItems": 15,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "jobId": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 100
                                      },
                                      "slotId": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 100
                                      }
                                    },
                                    "required": [
                                      "jobId",
                                      "slotId"
                                    ],
                                    "additionalProperties": false
                                  }
                                }
                              },
                              "required": [
                                "kind",
                                "jobIds",
                                "neighborSlotIds",
                                "deficiency",
                                "maximumMatching"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "availabilityVerified",
                            "timeUnit",
                            "timeOrigin",
                            "costUnit",
                            "jobIds",
                            "slotIds",
                            "status",
                            "schedule",
                            "maximumCardinality",
                            "witness"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "assignment-cost-optimize",
                  "version": "0.29.0",
                  "result": {
                    "profile": "fixed-slot-exact-assignment-v1",
                    "externalRequests": 0,
                    "execution": false,
                    "availabilityVerified": false,
                    "timeUnit": "minute",
                    "timeOrigin": "caller-defined zero",
                    "costUnit": "model cost units",
                    "jobIds": [
                      "a",
                      "b",
                      "c"
                    ],
                    "slotIds": [
                      "s1",
                      "s2",
                      "s3"
                    ],
                    "status": "optimal",
                    "assignments": [
                      {
                        "jobId": "a",
                        "slotId": "s2",
                        "start": 10,
                        "end": 20,
                        "cost": "1"
                      },
                      {
                        "jobId": "b",
                        "slotId": "s1",
                        "start": 0,
                        "end": 10,
                        "cost": "2"
                      },
                      {
                        "jobId": "c",
                        "slotId": "s3",
                        "start": 20,
                        "end": 30,
                        "cost": "1"
                      }
                    ],
                    "schedule": [
                      {
                        "jobId": "b",
                        "slotId": "s1",
                        "start": 0,
                        "end": 10,
                        "cost": "2"
                      },
                      {
                        "jobId": "a",
                        "slotId": "s2",
                        "start": 10,
                        "end": 20,
                        "cost": "1"
                      },
                      {
                        "jobId": "c",
                        "slotId": "s3",
                        "start": 20,
                        "end": 30,
                        "cost": "1"
                      }
                    ],
                    "unusedSlotIds": [],
                    "totalCost": {
                      "numerator": "4",
                      "denominator": "1"
                    },
                    "certificate": {
                      "kind": "min-cost-flow-potentials",
                      "scale": "1",
                      "primaryMultiplier": "64",
                      "tieBase": 4,
                      "combinedCost": "274",
                      "vertexPotentials": [
                        "0",
                        "48",
                        "0",
                        "62",
                        "128",
                        "128",
                        "128",
                        "128"
                      ],
                      "requiredFlow": 3,
                      "achievedFlow": 3
                    }
                  },
                  "provenance": {
                    "inputSha256": "f9e5201837d942fee4208f1463702123eb7efe360904719bc8393f0680cdfd7f",
                    "outputSha256": "e078060ea2c9b79dfff96c4e2bcff3a77cd038736ab4285f0d4d4561e1e2065f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/merkle-bundle-compose": {
      "post": {
        "operationId": "x402_merkle_bundle_compose",
        "summary": "Count-bound Merkle artifact bundle",
        "description": "Compose a local SHA-256 Merkle content commitment binding exact IDs, bytes and item count, plus selected shape-aware inclusion paths. This is consistency with a separately trusted root, not identity, signature, authenticity, confidentiality, completeness, timestamp or file-safety verification.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/merkle-bundle-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Commit an artifact bundle to one count-bound content root",
            "Produce selective inclusion proofs for supplied artifact bytes"
          ],
          "whenToUse": [
            "Hand off one supplied artifact and its logarithmic inclusion path without resending the full bundle"
          ],
          "whenNotToUse": [
            "Signatures, certificate transparency, blockchain protocol compatibility, append-only proofs or trusted root distribution",
            "Authentication, identity, confidentiality, timestamping, safety or complete-item-list verification",
            "Executing code, writing files, environment changes, network requests, publishing or deployment"
          ],
          "capabilities": [
            "Domain bytes 00 for framed leaves, 01 for internal pairs and 02 for count-bound public root",
            "Exact UTF-16 ID sorting; canonical base64 and UTF-8 equivalence",
            "Greatest-power-of-two split without leaf duplication; cached tree, bottom-up sibling orientation",
            "Verifier must validate index, count and exact expected proof shape; hashes do not anonymize low-entropy content",
            "Complete bounded computation before payment challenge and execution; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "items": 128,
            "proofs": 128,
            "idUnits": 100,
            "decodedBytes": 60000,
            "treeNodes": 255,
            "hashCalls": 256,
            "proofSiblings": 7
          },
          "related": [
            "content-digest",
            "artifact-manifest-check",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "DUPLICATE_ID",
            "DUPLICATE_PROOF_ID",
            "UNKNOWN_PROOF_ID",
            "PAYLOAD_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "items": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "id",
                        "encoding",
                        "data"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "proofIds": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  }
                },
                "required": [
                  "items",
                  "proofIds"
                ],
                "additionalProperties": false
              },
              "example": {
                "items": [
                  {
                    "id": "a",
                    "encoding": "utf8",
                    "data": "A"
                  },
                  {
                    "id": "b",
                    "encoding": "utf8",
                    "data": "B"
                  },
                  {
                    "id": "c",
                    "encoding": "base64",
                    "data": "AP8="
                  }
                ],
                "proofIds": [
                  "a"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "merkle-bundle-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "id-bytes-merkle-sha256-v1"
                        },
                        "root": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "treeHash": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "itemCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 128
                        },
                        "manifest": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "byteLength": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "leafHash": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              }
                            },
                            "required": [
                              "id",
                              "index",
                              "byteLength",
                              "leafHash"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "proofs": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "itemCount": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 128
                              },
                              "siblings": {
                                "maxItems": 7,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "side": {
                                      "type": "string",
                                      "enum": [
                                        "left",
                                        "right"
                                      ]
                                    },
                                    "hash": {
                                      "type": "string",
                                      "pattern": "^[a-f0-9]{64}$"
                                    }
                                  },
                                  "required": [
                                    "side",
                                    "hash"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "id",
                              "index",
                              "itemCount",
                              "siblings"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "authenticityVerified": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "root",
                        "treeHash",
                        "itemCount",
                        "manifest",
                        "proofs",
                        "externalRequests",
                        "authenticityVerified"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "merkle-bundle-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "id-bytes-merkle-sha256-v1",
                    "root": "4f60c66aed8c8da2fe90771108c10a02951b380ab0c0e5b515c619cc0a8f1d9d",
                    "treeHash": "d85a25d6b37e6f85dd8eee6489845d06e42c8df14567ca344a8bd833524c6c03",
                    "itemCount": 3,
                    "manifest": [
                      {
                        "id": "a",
                        "index": 0,
                        "byteLength": 1,
                        "leafHash": "728d8462eee330125f9b80cc67dabc50d2b19be470f4e0db6dae1db8479fd68e"
                      },
                      {
                        "id": "b",
                        "index": 1,
                        "byteLength": 1,
                        "leafHash": "0b17a04d58081b5d3fbbf2b58e132ca9857cb7a806d8b6590df3c498a4e717e3"
                      },
                      {
                        "id": "c",
                        "index": 2,
                        "byteLength": 2,
                        "leafHash": "896c085e5286e008c46dc1219c9508f2f575f0dd667a48af63f8efdcda36fc31"
                      }
                    ],
                    "proofs": [
                      {
                        "id": "a",
                        "index": 0,
                        "itemCount": 3,
                        "siblings": [
                          {
                            "side": "right",
                            "hash": "0b17a04d58081b5d3fbbf2b58e132ca9857cb7a806d8b6590df3c498a4e717e3"
                          },
                          {
                            "side": "right",
                            "hash": "896c085e5286e008c46dc1219c9508f2f575f0dd667a48af63f8efdcda36fc31"
                          }
                        ]
                      }
                    ],
                    "externalRequests": 0,
                    "authenticityVerified": false
                  },
                  "provenance": {
                    "inputSha256": "589ef52b234d843c25226c2fcfa453e7a2980ec2b03514bb6c26acdf277db550",
                    "outputSha256": "5d213c82d85b14afdd8492030f41aae579136720b2567ff6fb1577714478bca4",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/env-example-compose": {
      "post": {
        "operationId": "x402_env_example_compose",
        "summary": "Names-only secret dotenv example",
        "description": "Compose a deterministic literal .env.example and unresolved-variable checklist from explicit public and names-only secret declarations. Secret declarations accept no value/default field. Names-only secret declarations; public values supplied by the caller. No secret detection, secret-free certification, environment reads or changes.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/env-example-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate an env example file with names-only secret placeholders",
            "Produce an unresolved configuration-variable checklist"
          ],
          "whenToUse": [
            "Compile explicit declarations into a deterministic dotenv example with literal public defaults"
          ],
          "whenNotToUse": [
            "Secret scanning, secret-free certification, retrieving credentials or classifying whether caller public values contain secrets",
            "Shell sourcing, escape syntax, variable interpolation, production configuration or environment mutation",
            "Executing code, writing files, environment changes, network requests, publishing or deployment"
          ],
          "capabilities": [
            "Public defaults use single quotes; prohibited characters are rejected rather than escaped",
            "Secret declarations have no accepted default or value field; unresolved variables are comment-only",
            "Names-only secret declarations; public values supplied by the caller.",
            "Required and optional unresolved names and sorted declaration manifest; exact UTF-8 text length",
            "Complete bounded computation before payment challenge and execution; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "variables": 128,
            "nameUnits": 64,
            "descriptionUnits": 256,
            "defaultBytes": 2048,
            "textBytes": 100000
          },
          "related": [
            "template-render",
            "merkle-bundle-compose",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_NAME",
            "INVALID_DESCRIPTION",
            "INVALID_LITERAL",
            "DEFAULT_LIMIT",
            "TEXT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "variables": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "public"
                            },
                            "required": {
                              "type": "boolean"
                            },
                            "description": {
                              "type": "string",
                              "maxLength": 256
                            },
                            "default": {
                              "type": "string",
                              "maxLength": 2048
                            }
                          },
                          "required": [
                            "name",
                            "kind",
                            "required"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "secret"
                            },
                            "required": {
                              "type": "boolean"
                            },
                            "description": {
                              "type": "string",
                              "maxLength": 256
                            }
                          },
                          "required": [
                            "name",
                            "kind",
                            "required"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "variables"
                ],
                "additionalProperties": false
              },
              "example": {
                "variables": [
                  {
                    "name": "API_BASE",
                    "kind": "public",
                    "required": true,
                    "default": "https://example.invalid/v1"
                  },
                  {
                    "name": "API_KEY",
                    "kind": "secret",
                    "required": true
                  },
                  {
                    "name": "DEBUG",
                    "kind": "public",
                    "required": false,
                    "default": "false"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "env-example-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "dotenv-literal-example-v1"
                        },
                        "text": {
                          "type": "string"
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "declaredSecretNames": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                          }
                        },
                        "requiredWithoutDefaults": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                          }
                        },
                        "optionalWithoutDefaults": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                          }
                        },
                        "manifest": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "public",
                                  "secret"
                                ]
                              },
                              "required": {
                                "type": "boolean"
                              },
                              "hasDefault": {
                                "type": "boolean"
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "kind",
                              "required",
                              "hasDefault",
                              "description"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "classification": {
                          "type": "string",
                          "const": "Names-only secret declarations; public values supplied by the caller."
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "environmentChanged": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "text",
                        "byteLength",
                        "declaredSecretNames",
                        "requiredWithoutDefaults",
                        "optionalWithoutDefaults",
                        "manifest",
                        "classification",
                        "externalRequests",
                        "environmentChanged"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "env-example-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "dotenv-literal-example-v1",
                    "text": "API_BASE='https://example.invalid/v1'\n# Required secret: API_KEY\nDEBUG='false'\n",
                    "byteLength": 79,
                    "declaredSecretNames": [
                      "API_KEY"
                    ],
                    "requiredWithoutDefaults": [
                      "API_KEY"
                    ],
                    "optionalWithoutDefaults": [],
                    "manifest": [
                      {
                        "name": "API_BASE",
                        "kind": "public",
                        "required": true,
                        "hasDefault": true,
                        "description": null
                      },
                      {
                        "name": "API_KEY",
                        "kind": "secret",
                        "required": true,
                        "hasDefault": false,
                        "description": null
                      },
                      {
                        "name": "DEBUG",
                        "kind": "public",
                        "required": false,
                        "hasDefault": true,
                        "description": null
                      }
                    ],
                    "classification": "Names-only secret declarations; public values supplied by the caller.",
                    "externalRequests": 0,
                    "environmentChanged": false
                  },
                  "provenance": {
                    "inputSha256": "53598ba3cbc88dca06116cd5d2e1aee89d6e21bfee339ed11bb4bf77ea3b654f",
                    "outputSha256": "58044952de5e7a5301a62a40a7f0804e8c887d429e45436c16002485fa32d136",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/availability-slots-compose": {
      "post": {
        "operationId": "x402_availability_slots_compose",
        "summary": "Supplied-calendar availability slot composer",
        "description": "Compose all grid-aligned candidate meetings with whole-slot attendee continuity, required participants and explicit meeting buffers from supplied available/busy intervals.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/availability-slots-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "find candidate meeting slots from supplied calendars",
            "enumerate whole-meeting attendee availability",
            "compose buffered quorum meeting candidates"
          ],
          "whenToUse": [
            "find candidate meeting slots from supplied calendars",
            "enumerate whole-meeting attendee availability",
            "compose buffered quorum meeting candidates"
          ],
          "whenNotToUse": [
            "Live account access, invitations, booking or authenticating external observations",
            "Aggregate concurrency without the same attendees available for the entire meeting",
            "Ranked preferences, scheduling optimization or a conflict-free set of meetings",
            "Accessing calendars, scheduling jobs, reserving meetings, network requests or external state changes"
          ],
          "capabilities": [
            "Half-open intervals; union available and busy separately, subtract busy, then fit each attendee's protected meeting span; supplied availability is not verified",
            "Buffers may extend outside search window only within supplied free intervals",
            "Explicit grid origin permits negative conceptual grid indices; sorted complete attendee lists and all eligible candidates",
            "Caller-supplied data only; no current clock, randomness, environment or timezone-database reads",
            "Complete bounded validation before payment challenge; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "supplied-calendar-grid-v1",
            "participants": 32,
            "intervals": 512,
            "endpointTicks": 1000000000000,
            "windowTicks": 1000000000,
            "durationStepBufferTicks": 1000000000,
            "consideredStarts": 4096,
            "slots": 1024,
            "primitiveComparisons": 1000000,
            "labelCodeUnits": 128
          },
          "related": [
            "interval-analyze",
            "icalendar-compose",
            "assignment-cost-optimize"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INTERVAL",
            "INVALID_WINDOW",
            "INVALID_ATTENDEE_COUNT",
            "DUPLICATE_ID"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "window": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000000000
                      },
                      "end": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000000000
                      }
                    },
                    "required": [
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  },
                  "duration": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000000
                  },
                  "step": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000000
                  },
                  "gridOrigin": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000000000
                  },
                  "unit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "minimumAttendees": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 32
                  },
                  "participants": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64,
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                        },
                        "required": {
                          "type": "boolean"
                        },
                        "available": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "busy": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "bufferBefore": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000
                        },
                        "bufferAfter": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000
                        }
                      },
                      "required": [
                        "id",
                        "required",
                        "available",
                        "busy",
                        "bufferBefore",
                        "bufferAfter"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "window",
                  "duration",
                  "step",
                  "gridOrigin",
                  "unit",
                  "minimumAttendees",
                  "participants"
                ],
                "additionalProperties": false
              },
              "example": {
                "window": {
                  "start": 0,
                  "end": 120
                },
                "duration": 30,
                "step": 15,
                "gridOrigin": 0,
                "unit": "minutes-from-supplied-origin",
                "minimumAttendees": 2,
                "participants": [
                  {
                    "id": "A",
                    "required": true,
                    "available": [
                      {
                        "start": 0,
                        "end": 120
                      }
                    ],
                    "busy": [
                      {
                        "start": 30,
                        "end": 45
                      }
                    ],
                    "bufferBefore": 0,
                    "bufferAfter": 0
                  },
                  {
                    "id": "B",
                    "required": false,
                    "available": [
                      {
                        "start": 15,
                        "end": 90
                      }
                    ],
                    "busy": [],
                    "bufferBefore": 0,
                    "bufferAfter": 0
                  },
                  {
                    "id": "C",
                    "required": false,
                    "available": [
                      {
                        "start": 60,
                        "end": 120
                      }
                    ],
                    "busy": [],
                    "bufferBefore": 0,
                    "bufferAfter": 0
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "availability-slots-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "supplied-calendar-grid-v1"
                        },
                        "unit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "consideredStarts": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 4096
                        },
                        "slots": {
                          "maxItems": 1024,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "attendeeIds": {
                                "minItems": 1,
                                "maxItems": 32,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64,
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                                }
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "attendeeIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "complete": {
                          "type": "boolean",
                          "const": true
                        },
                        "availabilityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "unit",
                        "consideredStarts",
                        "slots",
                        "complete",
                        "availabilityVerified",
                        "execution"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "availability-slots-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "supplied-calendar-grid-v1",
                    "unit": "minutes-from-supplied-origin",
                    "consideredStarts": 7,
                    "slots": [
                      {
                        "start": 45,
                        "end": 75,
                        "attendeeIds": [
                          "A",
                          "B"
                        ]
                      },
                      {
                        "start": 60,
                        "end": 90,
                        "attendeeIds": [
                          "A",
                          "B",
                          "C"
                        ]
                      },
                      {
                        "start": 75,
                        "end": 105,
                        "attendeeIds": [
                          "A",
                          "C"
                        ]
                      },
                      {
                        "start": 90,
                        "end": 120,
                        "attendeeIds": [
                          "A",
                          "C"
                        ]
                      }
                    ],
                    "complete": true,
                    "availabilityVerified": false,
                    "execution": false
                  },
                  "provenance": {
                    "inputSha256": "7ae7ef63263d7ff8b510767d3a8eea50e01fc39c9dab15988e2379a3f92c8c6a",
                    "outputSha256": "347105516dc56b43ed286eab482e138976e52026adfba297f7c6d7433921d895",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/time-series-grid-compose": {
      "post": {
        "operationId": "x402_time_series_grid_compose",
        "summary": "Exact supported time-series grid composer",
        "description": "Compose an aligned grid from supplied nonoverlapping piecewise-constant segments with exact rational integrals, means over supplied support and source contribution durations.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/time-series-grid-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "resample piecewise-constant time series to an exact aligned grid",
            "calculate time-weighted means over explicit supplied support",
            "compose exact rational series cells with missing-support evidence"
          ],
          "whenToUse": [
            "resample piecewise-constant time series to an exact aligned grid",
            "calculate time-weighted means over explicit supplied support",
            "compose exact rational series cells with missing-support evidence"
          ],
          "whenNotToUse": [
            "Interpolation, zero filling, extrapolation or last-observation carry-forward",
            "Overlapping segments within one series or undeclared measurement validity",
            "Floating-point approximations, display rounding or inference of observation quality",
            "Accessing calendars, scheduling jobs, reserving meetings, network requests or external state changes"
          ],
          "capabilities": [
            "Exact reduced rational value-times-ticks integrals and support-only means; zero support yields null mean",
            "Per-cell support completeness and sorted source-duration contributions; complete result does not imply complete data support",
            "Canonical shortest signed decimal values: up to 12 integer digits and 6 fractional digits; no negative zero or trailing fractional zeros",
            "Nonoverlapping sources are clipped to the grid; empty series is valid and source order is irrelevant",
            "Caller-supplied data only; no current clock, randomness, environment or timezone-database reads",
            "Complete bounded validation before payment challenge; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "explicit-support-grid-v1",
            "series": 8,
            "segments": 1000,
            "cellsPerSeries": 256,
            "aggregateCells": 512,
            "contributions": 2000,
            "endpointTicks": 1000000000000,
            "valueIntegerDigits": 12,
            "valueFractionalDigits": 6,
            "labelCodeUnits": 128
          },
          "related": [
            "time-series-inspect",
            "records-aggregate",
            "decimal-distribution-summarize"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INTERVAL",
            "INVALID_GRID",
            "OVERLAPPING_SEGMENTS",
            "DUPLICATE_ID"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "window": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000000000
                      },
                      "end": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000000000
                      }
                    },
                    "required": [
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  },
                  "step": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000000000
                  },
                  "timeUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "valueUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "series": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64,
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                        },
                        "segments": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64,
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 20,
                                "pattern": "^(?!-0$)-?(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{0,5}[1-9])?$"
                              }
                            },
                            "required": [
                              "id",
                              "start",
                              "end",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "segments"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "window",
                  "step",
                  "timeUnit",
                  "valueUnit",
                  "series"
                ],
                "additionalProperties": false
              },
              "example": {
                "window": {
                  "start": 0,
                  "end": 12
                },
                "step": 4,
                "timeUnit": "seconds",
                "valueUnit": "requests-per-second",
                "series": [
                  {
                    "id": "load",
                    "segments": [
                      {
                        "id": "a",
                        "start": 0,
                        "end": 3,
                        "value": "2"
                      },
                      {
                        "id": "b",
                        "start": 3,
                        "end": 7,
                        "value": "4"
                      },
                      {
                        "id": "c",
                        "start": 9,
                        "end": 12,
                        "value": "1"
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "time-series-grid-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "explicit-support-grid-v1"
                        },
                        "timeUnit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "valueUnit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "series": {
                          "minItems": 1,
                          "maxItems": 8,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64,
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                              },
                              "cells": {
                                "minItems": 1,
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "start": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000000000000
                                    },
                                    "end": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000000000000
                                    },
                                    "supportedTicks": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000000000000
                                    },
                                    "integral": {
                                      "type": "object",
                                      "properties": {
                                        "numerator": {
                                          "type": "string",
                                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                        },
                                        "denominator": {
                                          "type": "string",
                                          "pattern": "^[1-9][0-9]*$"
                                        }
                                      },
                                      "required": [
                                        "numerator",
                                        "denominator"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "meanOverSupport": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "numerator": {
                                              "type": "string",
                                              "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                            },
                                            "denominator": {
                                              "type": "string",
                                              "pattern": "^[1-9][0-9]*$"
                                            }
                                          },
                                          "required": [
                                            "numerator",
                                            "denominator"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "completeSupport": {
                                      "type": "boolean"
                                    },
                                    "contributions": {
                                      "maxItems": 1000,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "segmentId": {
                                            "type": "string",
                                            "minLength": 1,
                                            "maxLength": 64,
                                            "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                                          },
                                          "ticks": {
                                            "type": "integer",
                                            "minimum": 1,
                                            "maximum": 1000000000000
                                          }
                                        },
                                        "required": [
                                          "segmentId",
                                          "ticks"
                                        ],
                                        "additionalProperties": false
                                      }
                                    }
                                  },
                                  "required": [
                                    "start",
                                    "end",
                                    "supportedTicks",
                                    "integral",
                                    "meanOverSupport",
                                    "completeSupport",
                                    "contributions"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "id",
                              "cells"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "complete": {
                          "type": "boolean",
                          "const": true
                        }
                      },
                      "required": [
                        "profile",
                        "timeUnit",
                        "valueUnit",
                        "series",
                        "complete"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "time-series-grid-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-support-grid-v1",
                    "timeUnit": "seconds",
                    "valueUnit": "requests-per-second",
                    "series": [
                      {
                        "id": "load",
                        "cells": [
                          {
                            "start": 0,
                            "end": 4,
                            "supportedTicks": 4,
                            "integral": {
                              "numerator": "10",
                              "denominator": "1"
                            },
                            "meanOverSupport": {
                              "numerator": "5",
                              "denominator": "2"
                            },
                            "completeSupport": true,
                            "contributions": [
                              {
                                "segmentId": "a",
                                "ticks": 3
                              },
                              {
                                "segmentId": "b",
                                "ticks": 1
                              }
                            ]
                          },
                          {
                            "start": 4,
                            "end": 8,
                            "supportedTicks": 3,
                            "integral": {
                              "numerator": "12",
                              "denominator": "1"
                            },
                            "meanOverSupport": {
                              "numerator": "4",
                              "denominator": "1"
                            },
                            "completeSupport": false,
                            "contributions": [
                              {
                                "segmentId": "b",
                                "ticks": 3
                              }
                            ]
                          },
                          {
                            "start": 8,
                            "end": 12,
                            "supportedTicks": 3,
                            "integral": {
                              "numerator": "3",
                              "denominator": "1"
                            },
                            "meanOverSupport": {
                              "numerator": "1",
                              "denominator": "1"
                            },
                            "completeSupport": false,
                            "contributions": [
                              {
                                "segmentId": "c",
                                "ticks": 3
                              }
                            ]
                          }
                        ]
                      }
                    ],
                    "complete": true
                  },
                  "provenance": {
                    "inputSha256": "aca420f4b753b855599d4f1fbe71cbae95db8b4c354530674f361c412b0151a1",
                    "outputSha256": "8fd5e070be522a17b80a4916857c16ce588d5cd527fa2c39465dd7b00dfe31f1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/cron-occurrences-expand": {
      "post": {
        "operationId": "x402_cron_occurrences_expand",
        "summary": "Supplied-offset cron occurrence expander",
        "description": "Expand bounded five-field cron into complete UTC occurrences using an exact caller-supplied offset timeline, including every fold instant and no nonexistent gap minute.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/cron-occurrences-expand.md"
        },
        "x-agent-discovery": {
          "intents": [
            "expand cron occurrences in a supplied UTC window",
            "enumerate fixed-offset or UTC cron schedules offline",
            "inspect cron gap and fold matches against supplied offset periods"
          ],
          "whenToUse": [
            "expand cron occurrences in a supplied UTC window",
            "enumerate fixed-offset or UTC cron schedules offline",
            "inspect cron gap and fold matches against supplied offset periods"
          ],
          "whenNotToUse": [
            "An IANA timezone name without an explicit trusted offset-period timeline",
            "Daemon scheduling, Cronie clock-jump replay, catch-up or once-per-wall-time suppression",
            "Quartz, seconds/year fields, names, macros, hashed values, command suffixes or Sunday 7",
            "Accessing calendars, scheduling jobs, reserving meetings, network requests or external state changes"
          ],
          "capabilities": [
            "UTC and fixed offsets need one period spanning the exact window; labels are inert metadata and timezone rules are unverified",
            "Sorted contiguous offset periods are normalized; splitting equal-offset periods leaves output unchanged",
            "Exact five-field decimal grammar; positive steps only on * or ascending ranges",
            "Day-of-month/day-of-week use OR when both restricted; either exact wildcard delegates to the other; stepped wildcards in these day fields are rejected",
            "Minute-aligned half-open UTC window, Gregorian dates, gap omission and every distinct fold instant; no hidden current time",
            "Caller-supplied data only; no current clock, randomness, environment or timezone-database reads",
            "Complete bounded validation before payment challenge; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "cron5-offset-periods-v1",
            "expressionCodeUnits": 256,
            "atoms": 32,
            "offsetPeriods": 32,
            "absoluteOffsetMinutes": 840,
            "windowDays": 366,
            "calendarDateVisits": 512,
            "prospectiveCandidates": 50000,
            "occurrences": 2000,
            "utcYears": "2000–2100",
            "timezoneLabelCodeUnits": 128
          },
          "related": [
            "recurrence-dates-expand",
            "timezone-convert",
            "icalendar-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_CRON",
            "INVALID_UTC_TIME",
            "INVALID_WINDOW",
            "INVALID_OFFSET_PERIODS"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "expression": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  },
                  "window": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "string",
                        "minLength": 20,
                        "maxLength": 20,
                        "pattern": "^(?:20[0-9]{2}|2100)-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00Z$"
                      },
                      "end": {
                        "type": "string",
                        "minLength": 20,
                        "maxLength": 20,
                        "pattern": "^(?:20[0-9]{2}|2100)-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00Z$"
                      }
                    },
                    "required": [
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  },
                  "timezone": {
                    "type": "object",
                    "properties": {
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 128,
                        "pattern": "^[\\x20-\\x7e]+$"
                      },
                      "periods": {
                        "minItems": 1,
                        "maxItems": 32,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "start": {
                              "type": "string",
                              "minLength": 20,
                              "maxLength": 20,
                              "pattern": "^(?:20[0-9]{2}|2100)-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00Z$"
                            },
                            "end": {
                              "type": "string",
                              "minLength": 20,
                              "maxLength": 20,
                              "pattern": "^(?:20[0-9]{2}|2100)-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00Z$"
                            },
                            "offsetMinutes": {
                              "type": "integer",
                              "minimum": -840,
                              "maximum": 840
                            }
                          },
                          "required": [
                            "start",
                            "end",
                            "offsetMinutes"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "label",
                      "periods"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "expression",
                  "window",
                  "timezone"
                ],
                "additionalProperties": false
              },
              "example": {
                "expression": "0 9 * * 1-5",
                "window": {
                  "start": "2026-10-05T00:00:00Z",
                  "end": "2026-10-08T00:00:00Z"
                },
                "timezone": {
                  "label": "UTC",
                  "periods": [
                    {
                      "start": "2026-10-05T00:00:00Z",
                      "end": "2026-10-08T00:00:00Z",
                      "offsetMinutes": 0
                    }
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "cron-occurrences-expand",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "cron5-offset-periods-v1"
                        },
                        "timezoneLabel": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "pattern": "^[\\x20-\\x7e]+$"
                        },
                        "occurrences": {
                          "maxItems": 2000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "instant": {
                                "type": "string",
                                "minLength": 20,
                                "maxLength": 20,
                                "pattern": "^(?:20[0-9]{2}|2100)-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00Z$"
                              },
                              "localDateTime": {
                                "type": "string",
                                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00$"
                              },
                              "offsetMinutes": {
                                "type": "integer",
                                "minimum": -840,
                                "maximum": 840
                              }
                            },
                            "required": [
                              "instant",
                              "localDateTime",
                              "offsetMinutes"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "complete": {
                          "type": "boolean",
                          "const": true
                        },
                        "rulesSource": {
                          "type": "string",
                          "const": "caller-supplied-offset-periods"
                        },
                        "timezoneRulesVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "timezoneLabel",
                        "occurrences",
                        "complete",
                        "rulesSource",
                        "timezoneRulesVerified",
                        "execution"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "cron-occurrences-expand",
                  "version": "0.29.0",
                  "result": {
                    "profile": "cron5-offset-periods-v1",
                    "timezoneLabel": "UTC",
                    "occurrences": [
                      {
                        "instant": "2026-10-05T09:00:00Z",
                        "localDateTime": "2026-10-05T09:00:00",
                        "offsetMinutes": 0
                      },
                      {
                        "instant": "2026-10-06T09:00:00Z",
                        "localDateTime": "2026-10-06T09:00:00",
                        "offsetMinutes": 0
                      },
                      {
                        "instant": "2026-10-07T09:00:00Z",
                        "localDateTime": "2026-10-07T09:00:00",
                        "offsetMinutes": 0
                      }
                    ],
                    "complete": true,
                    "rulesSource": "caller-supplied-offset-periods",
                    "timezoneRulesVerified": false,
                    "execution": false
                  },
                  "provenance": {
                    "inputSha256": "fe96d9515b4ae70eefd4667f72628cd07f8ccde455e53be969cc789539811a84",
                    "outputSha256": "9a7bd770faba0810104e5978c7661f2ff710afe70115d536c705d59a97b89a5b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/protobuf-message-compose": {
      "post": {
        "operationId": "x402_protobuf_message_compose",
        "summary": "Typed bounded Protobuf message composer",
        "description": "Compose actual proto3 wire bytes, matching explicit schema and exact field offsets from bounded acyclic integer/string/bytes declarations. Deterministic under this profile only; no universal canonical serialization, RPC, transport, credentials or execution.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/protobuf-message-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Prepare a typed binary message from an explicit Protobuf schema",
            "Produce a portable proto3 file and auditable byte offsets"
          ],
          "whenToUse": [
            "Prepare an inert request body or artifact for a separately authorized Protobuf consumer"
          ],
          "whenNotToUse": [
            "Recursive/imported schemas, floats, fixed-width types, enums, maps, oneofs, extensions or well-known types",
            "gRPC framing, sending a request, signatures or cross-implementation byte canonicality",
            "Executing code, writing files, environment changes, network requests, publishing or deployment"
          ],
          "capabilities": [
            "Exact decimal integer ranges, optional presence, default elision and packed repeated integers/booleans",
            "Ascending field-number order, canonical padded Base64 and absolute half-open offsets",
            "Acyclic schema validation including generated JSON-name conflicts",
            "Complete bounded computation before payment challenge and execution; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "messageTypes": 8,
            "declaredFields": 64,
            "messageDepth": 6,
            "valuesIncludingRoot": 1024,
            "decodedBytes": 60000,
            "wireBytes": 80000,
            "offsetRecordsIncludingElements": 2048
          },
          "related": [
            "zip-store-compose",
            "oci-artifact-compose",
            "blob-decode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_PROTO_NAME",
            "DUPLICATE_MESSAGE",
            "DUPLICATE_FIELD",
            "DUPLICATE_JSON_NAME",
            "UNKNOWN_PROTO_TYPE",
            "RESERVED_FIELD_NUMBER",
            "INVALID_CARDINALITY",
            "RECURSIVE_SCHEMA",
            "INVALID_PROTO_VALUE",
            "INTEGER_RANGE",
            "INVALID_BASE64",
            "UNKNOWN_PROTO_FIELD",
            "PAYLOAD_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "messages": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                        },
                        "fields": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                              },
                              "number": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 536870911
                              },
                              "type": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                              },
                              "cardinality": {
                                "type": "string",
                                "enum": [
                                  "implicit",
                                  "optional",
                                  "repeated"
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "number",
                              "type",
                              "cardinality"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "name",
                        "fields"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "rootType": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                  },
                  "value": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "$ref": "#/paths/~1v1~1x402~1protobuf-message-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                    }
                  }
                },
                "required": [
                  "messages",
                  "rootType",
                  "value"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1protobuf-message-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1protobuf-message-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "messages": [
                  {
                    "name": "Packet",
                    "fields": [
                      {
                        "name": "count",
                        "number": 1,
                        "type": "uint32",
                        "cardinality": "optional"
                      },
                      {
                        "name": "label",
                        "number": 2,
                        "type": "string",
                        "cardinality": "optional"
                      },
                      {
                        "name": "deltas",
                        "number": 3,
                        "type": "sint32",
                        "cardinality": "repeated"
                      }
                    ]
                  }
                ],
                "rootType": "Packet",
                "value": {
                  "count": "150",
                  "label": "Hi",
                  "deltas": [
                    "-1",
                    "2",
                    "3"
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "protobuf-message-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "proto3-bounded-integer-message-v1"
                        },
                        "rootType": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                        },
                        "base64": {
                          "type": "string"
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 80000
                        },
                        "protoSource": {
                          "type": "string"
                        },
                        "fieldRecords": {
                          "maxItems": 2048,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "fieldNumber": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 536870911
                              },
                              "wireType": {
                                "anyOf": [
                                  {
                                    "type": "number",
                                    "const": 0
                                  },
                                  {
                                    "type": "number",
                                    "const": 2
                                  }
                                ]
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "payloadStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "payloadEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "elements": {
                                "maxItems": 1023,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "path": {
                                      "type": "string"
                                    },
                                    "payloadStart": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "payloadEnd": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "path",
                                    "payloadStart",
                                    "payloadEnd"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "path",
                              "fieldNumber",
                              "wireType",
                              "start",
                              "end",
                              "payloadStart",
                              "payloadEnd"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "complete": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "rootType",
                        "base64",
                        "byteLength",
                        "protoSource",
                        "fieldRecords",
                        "complete",
                        "execution",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "protobuf-message-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "proto3-bounded-integer-message-v1",
                    "rootType": "Packet",
                    "base64": "CJYBEgJIaRoDAQQG",
                    "byteLength": 12,
                    "protoSource": "syntax = \"proto3\";\nmessage Packet {\n  optional uint32 count = 1;\n  optional string label = 2;\n  repeated sint32 deltas = 3;\n}\n",
                    "fieldRecords": [
                      {
                        "path": "/count",
                        "fieldNumber": 1,
                        "wireType": 0,
                        "start": 0,
                        "end": 3,
                        "payloadStart": 1,
                        "payloadEnd": 3
                      },
                      {
                        "path": "/label",
                        "fieldNumber": 2,
                        "wireType": 2,
                        "start": 3,
                        "end": 7,
                        "payloadStart": 5,
                        "payloadEnd": 7
                      },
                      {
                        "path": "/deltas",
                        "fieldNumber": 3,
                        "wireType": 2,
                        "start": 7,
                        "end": 12,
                        "payloadStart": 9,
                        "payloadEnd": 12,
                        "elements": [
                          {
                            "path": "/deltas/0",
                            "payloadStart": 9,
                            "payloadEnd": 10
                          },
                          {
                            "path": "/deltas/1",
                            "payloadStart": 10,
                            "payloadEnd": 11
                          },
                          {
                            "path": "/deltas/2",
                            "payloadStart": 11,
                            "payloadEnd": 12
                          }
                        ]
                      }
                    ],
                    "complete": true,
                    "execution": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "b408754708266e49ebe24f5620847540cf73dccf8a16f19ec5b2e7bf3e3ac4c6",
                    "outputSha256": "d2b66c67ba54385c24d502b4bab22d424af5faf77f1068d9f6e365598339a003",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/workflow-automata-compose": {
      "post": {
        "operationId": "x402_workflow_automata_compose",
        "summary": "Synchronous workflow language compiler",
        "description": "Compile two to four supplied deterministic finite event constraints into a minimized synchronous intersection machine, exact member classes and a shortest accepted trace. Missing transitions reject; no asynchronous interleaving, runtime execution, liveness, deadlock or authorization guarantee.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/workflow-automata-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Combine finite workflow constraints into one reusable deterministic machine",
            "Find the shortest event trace satisfying all supplied finite event policies"
          ],
          "whenToUse": [
            "Every component intentionally consumes every event from the same explicit common alphabet"
          ],
          "whenNotToUse": [
            "Asynchronous components, implicit unrelated-event self-loops, epsilon edges, guards, actions, counters or real-time predicates",
            "Policy appropriateness, safe concurrency, liveness, real-world deadlocks or permission to execute actions",
            "Executing code, writing files, environment changes, network requests, publishing or deployment"
          ],
          "capabilities": [
            "Reachable synchronous product, common rejecting sink and exact partition minimization",
            "Canonical breadth-first state IDs and lexicographically tied shortest accepted traces",
            "States without accepting continuations and explicit product-class membership",
            "Complete bounded computation before payment challenge and execution; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "machines": 4,
            "alphabet": 5,
            "statesPerMachine": 16,
            "inputStates": 64,
            "inputTransitions": 320,
            "reachableProductStates": 96,
            "productEdges": 480,
            "primitiveWork": 1000000
          },
          "related": [
            "workflow-transition-check",
            "workflow-dag-analyze"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_EVENT",
            "DUPLICATE_MACHINE",
            "DUPLICATE_STATE",
            "UNKNOWN_STATE",
            "UNKNOWN_EVENT",
            "DUPLICATE_TRANSITION"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "alphabet": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                    }
                  },
                  "machines": {
                    "minItems": 2,
                    "maxItems": 4,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                        },
                        "states": {
                          "minItems": 1,
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "initialState": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                        },
                        "acceptingStates": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "transitions": {
                          "maxItems": 80,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "from": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              },
                              "event": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              },
                              "to": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "required": [
                              "from",
                              "event",
                              "to"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "states",
                        "initialState",
                        "acceptingStates",
                        "transitions"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "alphabet",
                  "machines"
                ],
                "additionalProperties": false
              },
              "example": {
                "alphabet": [
                  "a",
                  "b"
                ],
                "machines": [
                  {
                    "id": "ending",
                    "states": [
                      "n",
                      "y"
                    ],
                    "initialState": "n",
                    "acceptingStates": [
                      "y"
                    ],
                    "transitions": [
                      {
                        "from": "n",
                        "event": "a",
                        "to": "y"
                      },
                      {
                        "from": "n",
                        "event": "b",
                        "to": "n"
                      },
                      {
                        "from": "y",
                        "event": "a",
                        "to": "y"
                      },
                      {
                        "from": "y",
                        "event": "b",
                        "to": "n"
                      }
                    ]
                  },
                  {
                    "id": "parity",
                    "states": [
                      "even",
                      "odd"
                    ],
                    "initialState": "even",
                    "acceptingStates": [
                      "even"
                    ],
                    "transitions": [
                      {
                        "from": "even",
                        "event": "a",
                        "to": "even"
                      },
                      {
                        "from": "even",
                        "event": "b",
                        "to": "odd"
                      },
                      {
                        "from": "odd",
                        "event": "a",
                        "to": "odd"
                      },
                      {
                        "from": "odd",
                        "event": "b",
                        "to": "even"
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "workflow-automata-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "finite-language-intersection-v1"
                        },
                        "semantics": {
                          "type": "string",
                          "const": "synchronous-common-alphabet"
                        },
                        "alphabet": {
                          "minItems": 1,
                          "maxItems": 5,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "machineOrder": {
                          "minItems": 2,
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "machine": {
                          "type": "object",
                          "properties": {
                            "states": {
                              "minItems": 1,
                              "maxItems": 96,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "initialState": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "acceptingStates": {
                              "maxItems": 96,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "transitions": {
                              "maxItems": 480,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "from": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                  },
                                  "event": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                  },
                                  "to": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                  }
                                },
                                "required": [
                                  "from",
                                  "event",
                                  "to"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "states",
                            "initialState",
                            "acceptingStates",
                            "transitions"
                          ],
                          "additionalProperties": false
                        },
                        "stateClasses": {
                          "minItems": 1,
                          "maxItems": 96,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "state": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              },
                              "memberTuples": {
                                "minItems": 1,
                                "maxItems": 96,
                                "type": "array",
                                "items": {
                                  "anyOf": [
                                    {
                                      "minItems": 2,
                                      "maxItems": 4,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                      }
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            },
                            "required": [
                              "state",
                              "memberTuples"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "shortestAcceptedTrace": {
                          "anyOf": [
                            {
                              "maxItems": 95,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "noAcceptingContinuationStates": {
                          "maxItems": 96,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "reachableProductStates": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 96
                        },
                        "complete": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "semantics",
                        "alphabet",
                        "machineOrder",
                        "machine",
                        "stateClasses",
                        "shortestAcceptedTrace",
                        "noAcceptingContinuationStates",
                        "reachableProductStates",
                        "complete",
                        "execution",
                        "authorizationGranted",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "workflow-automata-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "finite-language-intersection-v1",
                    "semantics": "synchronous-common-alphabet",
                    "alphabet": [
                      "a",
                      "b"
                    ],
                    "machineOrder": [
                      "ending",
                      "parity"
                    ],
                    "machine": {
                      "states": [
                        "q0",
                        "q1",
                        "q2"
                      ],
                      "initialState": "q0",
                      "acceptingStates": [
                        "q1"
                      ],
                      "transitions": [
                        {
                          "from": "q0",
                          "event": "a",
                          "to": "q1"
                        },
                        {
                          "from": "q0",
                          "event": "b",
                          "to": "q2"
                        },
                        {
                          "from": "q1",
                          "event": "a",
                          "to": "q1"
                        },
                        {
                          "from": "q1",
                          "event": "b",
                          "to": "q2"
                        },
                        {
                          "from": "q2",
                          "event": "a",
                          "to": "q2"
                        },
                        {
                          "from": "q2",
                          "event": "b",
                          "to": "q0"
                        }
                      ]
                    },
                    "stateClasses": [
                      {
                        "state": "q0",
                        "memberTuples": [
                          [
                            "n",
                            "even"
                          ]
                        ]
                      },
                      {
                        "state": "q1",
                        "memberTuples": [
                          [
                            "y",
                            "even"
                          ]
                        ]
                      },
                      {
                        "state": "q2",
                        "memberTuples": [
                          [
                            "n",
                            "odd"
                          ],
                          [
                            "y",
                            "odd"
                          ]
                        ]
                      }
                    ],
                    "shortestAcceptedTrace": [
                      "a"
                    ],
                    "noAcceptingContinuationStates": [],
                    "reachableProductStates": 4,
                    "complete": true,
                    "execution": false,
                    "authorizationGranted": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "67dafd2ccbbaa103d855310026fdbc6b8acc1b834468f130799030cf5ff348f2",
                    "outputSha256": "aa31a1b70e2b92d8c5ac67347d585ec1e211579759ddc258df4a7ad7161cc5a7",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/pairwise-cases-compose": {
      "post": {
        "operationId": "x402_pairwise_cases_compose",
        "summary": "Constrained pairwise fixture composer",
        "description": "Generate concrete rows covering every pair with a feasible complete assignment under bounded forbidden tuples, with exhaustive-coverage certificate and deterministic greedy ties. No minimum-suite or target-behavior claim.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/pairwise-cases-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate constrained pairwise test configurations",
            "Build concrete finite factor-level fixtures and a coverage manifest"
          ],
          "whenToUse": [
            "Ordered finite factors with literal forbidden tuples; caller separately runs tests"
          ],
          "whenNotToUse": [
            "Minimum test suites, arbitrary SAT predicates, unlimited Cartesian products or bug-finding guarantees",
            "Execute target code, call APIs, fetch data, run external agents, mutate accounts or deploy"
          ],
          "capabilities": [
            "Complete Cartesian feasibility enumeration and feasible-pair derivation",
            "Deterministic greedy coverage with first-covering row certificate",
            "Complete bounded result computed before challenge; atomic work/output failures"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 16,
            "factors": 12,
            "levelsPerFactor": 16,
            "forbiddenTuples": 64,
            "tupleArity": 4,
            "cartesianAssignments": 4096,
            "pairEntries": 4096,
            "suiteRows": 256,
            "tupleLiteralTests": 1100000,
            "pairPostings": 270336,
            "scoreComparisons": 1048576
          },
          "related": [
            "coverage-set-optimize",
            "json-batch-encode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_FACTOR",
            "DUPLICATE_LEVEL",
            "DUPLICATE_TUPLE_FACTOR",
            "UNKNOWN_LEVEL",
            "LABEL_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "factors": {
                    "minItems": 2,
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                        },
                        "levels": {
                          "minItems": 1,
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "string",
                                "maxLength": 128
                              },
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        }
                      },
                      "required": [
                        "id",
                        "levels"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "forbiddenTuples": {
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "factor": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          },
                          "levelIndex": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 15
                          }
                        },
                        "required": [
                          "factor",
                          "levelIndex"
                        ],
                        "additionalProperties": false
                      }
                    }
                  }
                },
                "required": [
                  "factors",
                  "forbiddenTuples"
                ],
                "additionalProperties": false
              },
              "example": {
                "factors": [
                  {
                    "id": "codec",
                    "levels": [
                      "json",
                      "msgpack"
                    ]
                  },
                  {
                    "id": "compression",
                    "levels": [
                      "none",
                      "gzip"
                    ]
                  },
                  {
                    "id": "transport",
                    "levels": [
                      "http",
                      "ws"
                    ]
                  }
                ],
                "forbiddenTuples": [
                  [
                    {
                      "factor": "codec",
                      "levelIndex": 1
                    },
                    {
                      "factor": "compression",
                      "levelIndex": 1
                    }
                  ]
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "pairwise-cases-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "finite-forbidden-tuples-greedy-pairwise-v1"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "complete",
                            "infeasible"
                          ]
                        },
                        "factorOrder": {
                          "minItems": 2,
                          "maxItems": 12,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "rows": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "maxLength": 128
                                },
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          }
                        },
                        "levelIndexRows": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "minItems": 2,
                            "maxItems": 12,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 15
                            }
                          }
                        },
                        "coverage": {
                          "type": "object",
                          "properties": {
                            "cartesianAssignmentCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 4096
                            },
                            "feasibleAssignmentCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 4096
                            },
                            "nominalPairCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "feasiblePairCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 4096
                            },
                            "excludedPairCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "pairs": {
                              "maxItems": 4096,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "factorIndexA": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 11
                                  },
                                  "levelIndexA": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 15
                                  },
                                  "factorIndexB": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 11
                                  },
                                  "levelIndexB": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 15
                                  },
                                  "firstCoveringRow": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 255
                                  }
                                },
                                "required": [
                                  "factorIndexA",
                                  "levelIndexA",
                                  "factorIndexB",
                                  "levelIndexB",
                                  "firstCoveringRow"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "complete": {
                              "type": "boolean",
                              "const": true
                            }
                          },
                          "required": [
                            "cartesianAssignmentCount",
                            "feasibleAssignmentCount",
                            "nominalPairCount",
                            "feasiblePairCount",
                            "excludedPairCount",
                            "pairs",
                            "complete"
                          ],
                          "additionalProperties": false
                        },
                        "minimumSuiteClaimed": {
                          "type": "boolean",
                          "const": false
                        },
                        "targetExecuted": {
                          "type": "boolean",
                          "const": false
                        },
                        "behaviorVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "factorOrder",
                        "rows",
                        "levelIndexRows",
                        "coverage",
                        "minimumSuiteClaimed",
                        "targetExecuted",
                        "behaviorVerified",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "pairwise-cases-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "finite-forbidden-tuples-greedy-pairwise-v1",
                    "status": "complete",
                    "factorOrder": [
                      "codec",
                      "compression",
                      "transport"
                    ],
                    "rows": [
                      {
                        "codec": "json",
                        "compression": "none",
                        "transport": "http"
                      },
                      {
                        "codec": "json",
                        "compression": "gzip",
                        "transport": "ws"
                      },
                      {
                        "codec": "msgpack",
                        "compression": "none",
                        "transport": "ws"
                      },
                      {
                        "codec": "json",
                        "compression": "gzip",
                        "transport": "http"
                      },
                      {
                        "codec": "msgpack",
                        "compression": "none",
                        "transport": "http"
                      }
                    ],
                    "levelIndexRows": [
                      [
                        0,
                        0,
                        0
                      ],
                      [
                        0,
                        1,
                        1
                      ],
                      [
                        1,
                        0,
                        1
                      ],
                      [
                        0,
                        1,
                        0
                      ],
                      [
                        1,
                        0,
                        0
                      ]
                    ],
                    "coverage": {
                      "cartesianAssignmentCount": 8,
                      "feasibleAssignmentCount": 6,
                      "nominalPairCount": 12,
                      "feasiblePairCount": 11,
                      "excludedPairCount": 1,
                      "pairs": [
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 0,
                          "factorIndexB": 1,
                          "levelIndexB": 0,
                          "firstCoveringRow": 0
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 0,
                          "factorIndexB": 1,
                          "levelIndexB": 1,
                          "firstCoveringRow": 1
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 1,
                          "factorIndexB": 1,
                          "levelIndexB": 0,
                          "firstCoveringRow": 2
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 0,
                          "factorIndexB": 2,
                          "levelIndexB": 0,
                          "firstCoveringRow": 0
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 0,
                          "factorIndexB": 2,
                          "levelIndexB": 1,
                          "firstCoveringRow": 1
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 1,
                          "factorIndexB": 2,
                          "levelIndexB": 0,
                          "firstCoveringRow": 4
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 1,
                          "factorIndexB": 2,
                          "levelIndexB": 1,
                          "firstCoveringRow": 2
                        },
                        {
                          "factorIndexA": 1,
                          "levelIndexA": 0,
                          "factorIndexB": 2,
                          "levelIndexB": 0,
                          "firstCoveringRow": 0
                        },
                        {
                          "factorIndexA": 1,
                          "levelIndexA": 0,
                          "factorIndexB": 2,
                          "levelIndexB": 1,
                          "firstCoveringRow": 2
                        },
                        {
                          "factorIndexA": 1,
                          "levelIndexA": 1,
                          "factorIndexB": 2,
                          "levelIndexB": 0,
                          "firstCoveringRow": 3
                        },
                        {
                          "factorIndexA": 1,
                          "levelIndexA": 1,
                          "factorIndexB": 2,
                          "levelIndexB": 1,
                          "firstCoveringRow": 1
                        }
                      ],
                      "complete": true
                    },
                    "minimumSuiteClaimed": false,
                    "targetExecuted": false,
                    "behaviorVerified": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "135abef0c032aca1063b6b8b62cac1383fb8a7ae86d14ac53c6db804c01e967d",
                    "outputSha256": "0bc60129130519d35d6e26acf194b298be21d801098331327f1e42a1643cd77c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/synthetic-records-compose": {
      "post": {
        "operationId": "x402_synthetic_records_compose",
        "summary": "Versioned seeded synthetic record composer",
        "description": "Generate reproducible JSON records from explicit integer sequences, uniform integers, Bernoulli draws and integer-weighted categories using sha256-counter-fields-v1. No real-PII source, population realism, privacy certification or cryptographic-randomness claim.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/synthetic-records-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate repeatable parser fixtures with an exact seed and distribution recipe",
            "Compose explicit synthetic records without a reference dataset"
          ],
          "whenToUse": [
            "Small inert fixture tables from elementary explicit sampling rules"
          ],
          "whenNotToUse": [
            "Exact quotas, realistic identities, PII anonymization, correlated populations, Gaussian or floating-point distributions",
            "Cryptographic tokens, secrets or unpredictable random draws",
            "Execute target code, call APIs, fetch data, run external agents, mutate accounts or deploy"
          ],
          "capabilities": [
            "Frozen SHA-256 field-addressed rejection sampling with independent field addition",
            "Returns complete recipe and version alongside all generated rows",
            "Complete bounded result computed before challenge; atomic work/output failures"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 16,
            "rows": 1000,
            "fields": 20,
            "cells": 3000,
            "categories": 32,
            "distributionRange": 1000000,
            "hashAttempts": 3150,
            "attemptsPerDraw": 32,
            "scalarLabelCodePoints": 64
          },
          "related": [
            "csv-serialize",
            "json-batch-encode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_FIELD",
            "DUPLICATE_CATEGORY",
            "LABEL_LIMIT",
            "INTEGER_RANGE",
            "INVALID_DISTRIBUTION",
            "SAMPLING_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "seed": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  },
                  "count": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000
                  },
                  "fields": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "sequence"
                            },
                            "start": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "step": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "start",
                            "step"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "uniformInteger"
                            },
                            "minimum": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "maximum": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "minimum",
                            "maximum"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "bernoulli"
                            },
                            "numerator": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1000000
                            },
                            "denominator": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 1000000
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "categorical"
                            },
                            "values": {
                              "minItems": 1,
                              "maxItems": 32,
                              "type": "array",
                              "items": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 128
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "boolean"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "weights": {
                              "minItems": 1,
                              "maxItems": 32,
                              "type": "array",
                              "items": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              }
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "values",
                            "weights"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "seed",
                  "count",
                  "fields"
                ],
                "additionalProperties": false
              },
              "example": {
                "seed": 7,
                "count": 5,
                "fields": [
                  {
                    "id": "rowId",
                    "kind": "sequence",
                    "start": 100,
                    "step": 1
                  },
                  {
                    "id": "tier",
                    "kind": "categorical",
                    "values": [
                      "free",
                      "pro"
                    ],
                    "weights": [
                      3,
                      1
                    ]
                  },
                  {
                    "id": "retries",
                    "kind": "uniformInteger",
                    "minimum": 0,
                    "maximum": 2
                  },
                  {
                    "id": "enabled",
                    "kind": "bernoulli",
                    "numerator": 1,
                    "denominator": 2
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "synthetic-records-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "sha256-counter-fields-v1"
                        },
                        "recipe": {
                          "type": "object",
                          "properties": {
                            "seed": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 4294967295
                            },
                            "count": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1000
                            },
                            "fields": {
                              "minItems": 1,
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "sequence"
                                      },
                                      "start": {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      },
                                      "step": {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "start",
                                      "step"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "uniformInteger"
                                      },
                                      "minimum": {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      },
                                      "maximum": {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "minimum",
                                      "maximum"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "bernoulli"
                                      },
                                      "numerator": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 1000000
                                      },
                                      "denominator": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 1000000
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "categorical"
                                      },
                                      "values": {
                                        "minItems": 1,
                                        "maxItems": 32,
                                        "type": "array",
                                        "items": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "maxLength": 128
                                            },
                                            {
                                              "type": "integer",
                                              "minimum": -9007199254740991,
                                              "maximum": 9007199254740991
                                            },
                                            {
                                              "type": "boolean"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        }
                                      },
                                      "weights": {
                                        "minItems": 1,
                                        "maxItems": 32,
                                        "type": "array",
                                        "items": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 1000000
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "values",
                                      "weights"
                                    ],
                                    "additionalProperties": false
                                  }
                                ]
                              }
                            }
                          },
                          "required": [
                            "seed",
                            "count",
                            "fields"
                          ],
                          "additionalProperties": false
                        },
                        "generatedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000
                        },
                        "rows": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "maxLength": 128
                                },
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          }
                        },
                        "hashAttempts": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 3150
                        },
                        "distributionSemantics": {
                          "type": "string",
                          "const": "addressed-pseudorandom-draws-not-exact-quotas"
                        },
                        "cryptographicRandomnessClaimed": {
                          "type": "boolean",
                          "const": false
                        },
                        "privacyCertification": {
                          "type": "boolean",
                          "const": false
                        },
                        "targetExecuted": {
                          "type": "boolean",
                          "const": false
                        },
                        "behaviorVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "recipe",
                        "generatedCount",
                        "rows",
                        "hashAttempts",
                        "distributionSemantics",
                        "cryptographicRandomnessClaimed",
                        "privacyCertification",
                        "targetExecuted",
                        "behaviorVerified",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "synthetic-records-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "sha256-counter-fields-v1",
                    "recipe": {
                      "seed": 7,
                      "count": 5,
                      "fields": [
                        {
                          "id": "rowId",
                          "kind": "sequence",
                          "start": 100,
                          "step": 1
                        },
                        {
                          "id": "tier",
                          "kind": "categorical",
                          "values": [
                            "free",
                            "pro"
                          ],
                          "weights": [
                            3,
                            1
                          ]
                        },
                        {
                          "id": "retries",
                          "kind": "uniformInteger",
                          "minimum": 0,
                          "maximum": 2
                        },
                        {
                          "id": "enabled",
                          "kind": "bernoulli",
                          "numerator": 1,
                          "denominator": 2
                        }
                      ]
                    },
                    "generatedCount": 5,
                    "rows": [
                      {
                        "rowId": 100,
                        "tier": "free",
                        "retries": 2,
                        "enabled": true
                      },
                      {
                        "rowId": 101,
                        "tier": "pro",
                        "retries": 2,
                        "enabled": false
                      },
                      {
                        "rowId": 102,
                        "tier": "free",
                        "retries": 1,
                        "enabled": true
                      },
                      {
                        "rowId": 103,
                        "tier": "free",
                        "retries": 1,
                        "enabled": true
                      },
                      {
                        "rowId": 104,
                        "tier": "pro",
                        "retries": 0,
                        "enabled": true
                      }
                    ],
                    "hashAttempts": 15,
                    "distributionSemantics": "addressed-pseudorandom-draws-not-exact-quotas",
                    "cryptographicRandomnessClaimed": false,
                    "privacyCertification": false,
                    "targetExecuted": false,
                    "behaviorVerified": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "909c7edf379b64904f4ded14a7059683a2de705bf8b90eadc574113e1dccf8c9",
                    "outputSha256": "c718fd50db16b53e1c7e64358975ce68a5efb0a3079ebccf04853683a3921f4b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/observation-shrink-plan": {
      "post": {
        "operationId": "x402_observation_shrink_plan",
        "summary": "Observed failure reduction planner",
        "description": "Select the smallest target-failing subsequence among supplied observations, reconcile conflicting evidence, and materialize missing one-deletion experiments. References are caller assertions; no target execution, reproduced bug or global minimum claim.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/observation-shrink-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Plan next reduction experiments from caller-supplied failure observations",
            "Materialize the smallest observed target-failing sequence and its evidence"
          ],
          "whenToUse": [
            "Caller already owns a harness and supplies bounded pass/fail/unresolved observations"
          ],
          "whenNotToUse": [
            "Autonomous ddmin, reproducing bugs, root-cause claims, global minimality or executing a target",
            "Unobserved harness identity, flakiness or causality verification",
            "Execute target code, call APIs, fetch data, run external agents, mutate accounts or deploy"
          ],
          "capabilities": [
            "Conflicting evidence detection and target-failure-aware deterministic selection",
            "Concrete one-deletion input queue, complete local supplied-pass certificate or explicit incompleteness",
            "Complete bounded result computed before challenge; atomic work/output failures"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 16,
            "atoms": 64,
            "observations": 512,
            "retainedIds": 64,
            "observationIdReferences": 16384,
            "atomValueBytes": 512,
            "nextExperiments": 64
          },
          "related": [
            "replay-divergence-check",
            "json-patch"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ATOM",
            "DUPLICATE_OBSERVATION",
            "ATOM_LIMIT",
            "UNKNOWN_ATOM",
            "INVALID_SUBSEQUENCE",
            "CONTEXT_MISMATCH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "atoms": {
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                        },
                        "value": {
                          "$ref": "#/paths/~1v1~1x402~1observation-shrink-plan/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "required": [
                        "id",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "initialRetainedIds": {
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                    }
                  },
                  "harnessRef": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "caseRef": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "failureKey": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "observations": {
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "harnessRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "caseRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "retainedIds": {
                              "maxItems": 64,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "outcome": {
                              "type": "string",
                              "const": "pass"
                            }
                          },
                          "required": [
                            "id",
                            "harnessRef",
                            "caseRef",
                            "retainedIds",
                            "outcome"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "harnessRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "caseRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "retainedIds": {
                              "maxItems": 64,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "outcome": {
                              "type": "string",
                              "const": "unresolved"
                            }
                          },
                          "required": [
                            "id",
                            "harnessRef",
                            "caseRef",
                            "retainedIds",
                            "outcome"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "harnessRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "caseRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "retainedIds": {
                              "maxItems": 64,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "outcome": {
                              "type": "string",
                              "const": "fail"
                            },
                            "failureKey": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            }
                          },
                          "required": [
                            "id",
                            "harnessRef",
                            "caseRef",
                            "retainedIds",
                            "outcome",
                            "failureKey"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "atoms",
                  "initialRetainedIds",
                  "harnessRef",
                  "caseRef",
                  "failureKey",
                  "observations"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1observation-shrink-plan/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1observation-shrink-plan/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "atoms": [
                  {
                    "id": "a",
                    "value": {
                      "op": "open"
                    }
                  },
                  {
                    "id": "b",
                    "value": {
                      "op": "configure",
                      "mode": "x"
                    }
                  },
                  {
                    "id": "c",
                    "value": {
                      "op": "trigger"
                    }
                  },
                  {
                    "id": "d",
                    "value": {
                      "op": "close"
                    }
                  }
                ],
                "initialRetainedIds": [
                  "a",
                  "b",
                  "c",
                  "d"
                ],
                "harnessRef": "harness-v1",
                "caseRef": "case-x",
                "failureKey": "E_X",
                "observations": [
                  {
                    "id": "full",
                    "harnessRef": "harness-v1",
                    "caseRef": "case-x",
                    "retainedIds": [
                      "a",
                      "b",
                      "c",
                      "d"
                    ],
                    "outcome": "fail",
                    "failureKey": "E_X"
                  },
                  {
                    "id": "reduced",
                    "harnessRef": "harness-v1",
                    "caseRef": "case-x",
                    "retainedIds": [
                      "a",
                      "c"
                    ],
                    "outcome": "fail",
                    "failureKey": "E_X"
                  },
                  {
                    "id": "a-pass",
                    "harnessRef": "harness-v1",
                    "caseRef": "case-x",
                    "retainedIds": [
                      "a"
                    ],
                    "outcome": "pass"
                  },
                  {
                    "id": "c-unresolved",
                    "harnessRef": "harness-v1",
                    "caseRef": "case-x",
                    "retainedIds": [
                      "c"
                    ],
                    "outcome": "unresolved"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "observation-shrink-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "supplied-observations-one-deletion-v1"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "planned",
                            "inconsistent-evidence",
                            "no-target-failure-observed"
                          ]
                        },
                        "harnessRef": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "caseRef": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "failureKey": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "selected": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "retainedIds": {
                                  "maxItems": 64,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                  }
                                },
                                "values": {
                                  "maxItems": 64,
                                  "type": "array",
                                  "items": {
                                    "$ref": "#/paths/~1v1~1x402~1observation-shrink-plan/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "observationIds": {
                                  "maxItems": 512,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                  }
                                }
                              },
                              "required": [
                                "retainedIds",
                                "values",
                                "observationIds"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "smallestAmongSuppliedObservations": {
                          "type": "boolean"
                        },
                        "globalMinimalityEstablished": {
                          "type": "boolean",
                          "const": false
                        },
                        "oneDeletionCertificate": {
                          "type": "string",
                          "enum": [
                            "supported-by-supplied-passes",
                            "incomplete",
                            "not-applicable"
                          ]
                        },
                        "neighbors": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "omittedAtomId": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              },
                              "retainedIds": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                }
                              },
                              "evidenceStatus": {
                                "type": "string",
                                "enum": [
                                  "pass",
                                  "unresolved",
                                  "untested",
                                  "other-failure"
                                ]
                              },
                              "observationIds": {
                                "maxItems": 512,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                }
                              }
                            },
                            "required": [
                              "omittedAtomId",
                              "retainedIds",
                              "evidenceStatus",
                              "observationIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "nextExperiments": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "harnessRef": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              "caseRef": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              "targetFailureKey": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              "omittedAtomId": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              },
                              "retainedIds": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                }
                              },
                              "values": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "$ref": "#/paths/~1v1~1x402~1observation-shrink-plan/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                }
                              },
                              "reason": {
                                "type": "string",
                                "enum": [
                                  "unresolved",
                                  "untested",
                                  "other-failure"
                                ]
                              }
                            },
                            "required": [
                              "harnessRef",
                              "caseRef",
                              "targetFailureKey",
                              "omittedAtomId",
                              "retainedIds",
                              "values",
                              "reason"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "conflicts": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "retainedIds": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                }
                              },
                              "observationIds": {
                                "maxItems": 512,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                }
                              }
                            },
                            "required": [
                              "retainedIds",
                              "observationIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "targetExecuted": {
                          "type": "boolean",
                          "const": false
                        },
                        "behaviorVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "harnessRef",
                        "caseRef",
                        "failureKey",
                        "selected",
                        "smallestAmongSuppliedObservations",
                        "globalMinimalityEstablished",
                        "oneDeletionCertificate",
                        "neighbors",
                        "nextExperiments",
                        "conflicts",
                        "targetExecuted",
                        "behaviorVerified",
                        "externalRequests"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1observation-shrink-plan/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1observation-shrink-plan/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "observation-shrink-plan",
                  "version": "0.29.0",
                  "result": {
                    "profile": "supplied-observations-one-deletion-v1",
                    "status": "planned",
                    "harnessRef": "harness-v1",
                    "caseRef": "case-x",
                    "failureKey": "E_X",
                    "selected": {
                      "retainedIds": [
                        "a",
                        "c"
                      ],
                      "values": [
                        {
                          "op": "open"
                        },
                        {
                          "op": "trigger"
                        }
                      ],
                      "observationIds": [
                        "reduced"
                      ]
                    },
                    "smallestAmongSuppliedObservations": true,
                    "globalMinimalityEstablished": false,
                    "oneDeletionCertificate": "incomplete",
                    "neighbors": [
                      {
                        "omittedAtomId": "a",
                        "retainedIds": [
                          "c"
                        ],
                        "evidenceStatus": "unresolved",
                        "observationIds": [
                          "c-unresolved"
                        ]
                      },
                      {
                        "omittedAtomId": "c",
                        "retainedIds": [
                          "a"
                        ],
                        "evidenceStatus": "pass",
                        "observationIds": [
                          "a-pass"
                        ]
                      }
                    ],
                    "nextExperiments": [
                      {
                        "harnessRef": "harness-v1",
                        "caseRef": "case-x",
                        "targetFailureKey": "E_X",
                        "omittedAtomId": "a",
                        "retainedIds": [
                          "c"
                        ],
                        "values": [
                          {
                            "op": "trigger"
                          }
                        ],
                        "reason": "unresolved"
                      }
                    ],
                    "conflicts": [],
                    "targetExecuted": false,
                    "behaviorVerified": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "67fbcdaab9d5b3fd35e6bf7d29e597bfffa06f507f26b5bd0f40c85e5809307a",
                    "outputSha256": "25ef2cfd69a0b40f6cd46f38112bed174cf4e4f5d35867388bd82becec52855a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-schema-fixtures-compose": {
      "post": {
        "operationId": "x402_json_schema_fixtures_compose",
        "summary": "Constructive typed-schema fixture composer",
        "description": "Compose a complete bounded basis of valid fixture values with per-goal coverage or unavailability under a small typed JSON Schema profile.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-schema-fixtures-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "generate valid boundary request bodies from a supported typed JSON schema",
            "compose goal-labelled schema fixtures for a caller-run validator harness"
          ],
          "whenToUse": [
            "generate valid boundary request bodies from a supported typed JSON schema",
            "compose goal-labelled schema fixtures for a caller-run validator harness"
          ],
          "whenNotToUse": [
            "Exhaustive input-space, every property combination or every array-position coverage",
            "Counterexamples proving schema compatibility or arbitrary satisfiability search",
            "Arbitrary JSON Schema, formats, regexes, references, combinators, nested objects or nested arrays",
            "Executing target tests, fetching services, running supplied code or proving security"
          ],
          "capabilities": [
            "Required-only baseline, one-property edges, optional presence, array length edges and first-item scalar edges",
            "Typed enum/const intersections and supported contradictions; impossible optional properties stay explicitly unavailable",
            "Deduplicated fixture values retain all construction goal IDs",
            "Closed constructive-json-schema-v1 profile; unsupported keywords are rejected rather than ignored",
            "Networkless deterministic supplied-data computation; no target behavior or full input-space coverage claim",
            "Atomic complete bounded computation before the payment challenge; no partial packet on resource overflow"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "inputNodes": 12000,
            "outputNodes": 50000,
            "depth": 16,
            "schemaNodes": 80,
            "properties": 32,
            "enumMembers": 16,
            "arrayItems": 16,
            "stringLength": 256,
            "fixtures": 128,
            "goals": 512,
            "mutations": 64,
            "validatorNodeVisits": 50000,
            "candidateBytes": 2000000,
            "jsonNodes": 12000,
            "profile": "constructive-json-schema-v1"
          },
          "related": [
            "json-contract-negative-cases",
            "json-schema-check",
            "json-schema-compatibility"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "UNSUPPORTED_SCHEMA",
            "INVALID_SCHEMA",
            "SCHEMA_LIMIT",
            "WORK_LIMIT",
            "GOAL_LIMIT",
            "FIXTURE_LIMIT",
            "SEED_LIMIT",
            "INVALID_SEED",
            "DUPLICATE_ID",
            "INVALID_POINTER",
            "MUTATION_LIMIT",
            "INTERNAL_INVARIANT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "schema": {
                    "$ref": "#/paths/~1v1~1x402~1json-schema-fixtures-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "schema"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-schema-fixtures-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-schema-fixtures-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "schema": {
                  "type": "object",
                  "required": [
                    "count",
                    "mode"
                  ],
                  "properties": {
                    "count": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 3
                    },
                    "mode": {
                      "type": "string",
                      "enum": [
                        "fast",
                        "safe"
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-schema-fixtures-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "constructive-json-schema-v1"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "complete",
                            "unsatisfiable"
                          ]
                        },
                        "fixtures": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "value": {
                                "$ref": "#/paths/~1v1~1x402~1json-schema-fixtures-compose/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              },
                              "goalIds": {
                                "maxItems": 512,
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "required": [
                              "id",
                              "value",
                              "goalIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "goals": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string"
                              },
                              "instancePath": {
                                "type": "string"
                              },
                              "schemaPath": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "covered",
                                  "unavailable"
                                ]
                              },
                              "fixtureIds": {
                                "maxItems": 128,
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "reason": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "kind",
                              "instancePath",
                              "schemaPath",
                              "status",
                              "fixtureIds",
                              "reason"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "reason": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "code": {
                                  "type": "string"
                                },
                                "schemaPath": {
                                  "type": "string"
                                },
                                "message": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "code",
                                "schemaPath",
                                "message"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "testing": {
                          "type": "object",
                          "properties": {
                            "targetExecuted": {
                              "type": "boolean",
                              "const": false
                            },
                            "behaviorVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "fullInputSpaceCoverage": {
                              "type": "boolean",
                              "const": false
                            }
                          },
                          "required": [
                            "targetExecuted",
                            "behaviorVerified",
                            "fullInputSpaceCoverage"
                          ],
                          "additionalProperties": false
                        },
                        "metrics": {
                          "type": "object",
                          "properties": {
                            "schemaNodes": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "validatorNodeVisits": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "schemaNodes",
                            "validatorNodeVisits"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "fixtures",
                        "goals",
                        "reason",
                        "testing",
                        "metrics"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-schema-fixtures-compose/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-schema-fixtures-compose/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-schema-fixtures-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "constructive-json-schema-v1",
                    "status": "complete",
                    "fixtures": [
                      {
                        "id": "f001",
                        "value": {
                          "count": 1,
                          "mode": "fast"
                        },
                        "goalIds": [
                          "g001",
                          "g002",
                          "g004"
                        ]
                      },
                      {
                        "id": "f002",
                        "value": {
                          "count": 3,
                          "mode": "fast"
                        },
                        "goalIds": [
                          "g003"
                        ]
                      },
                      {
                        "id": "f003",
                        "value": {
                          "count": 1,
                          "mode": "safe"
                        },
                        "goalIds": [
                          "g005"
                        ]
                      }
                    ],
                    "goals": [
                      {
                        "id": "g001",
                        "kind": "baseline",
                        "instancePath": "",
                        "schemaPath": "",
                        "status": "covered",
                        "fixtureIds": [
                          "f001"
                        ],
                        "reason": null
                      },
                      {
                        "id": "g002",
                        "kind": "minimum",
                        "instancePath": "/count",
                        "schemaPath": "/properties/count/minimum",
                        "status": "covered",
                        "fixtureIds": [
                          "f001"
                        ],
                        "reason": null
                      },
                      {
                        "id": "g003",
                        "kind": "maximum",
                        "instancePath": "/count",
                        "schemaPath": "/properties/count/maximum",
                        "status": "covered",
                        "fixtureIds": [
                          "f002"
                        ],
                        "reason": null
                      },
                      {
                        "id": "g004",
                        "kind": "enum:0",
                        "instancePath": "/mode",
                        "schemaPath": "/properties/mode/enum",
                        "status": "covered",
                        "fixtureIds": [
                          "f001"
                        ],
                        "reason": null
                      },
                      {
                        "id": "g005",
                        "kind": "enum:1",
                        "instancePath": "/mode",
                        "schemaPath": "/properties/mode/enum",
                        "status": "covered",
                        "fixtureIds": [
                          "f003"
                        ],
                        "reason": null
                      }
                    ],
                    "reason": null,
                    "testing": {
                      "targetExecuted": false,
                      "behaviorVerified": false,
                      "fullInputSpaceCoverage": false
                    },
                    "metrics": {
                      "schemaNodes": 3,
                      "validatorNodeVisits": 17
                    }
                  },
                  "provenance": {
                    "inputSha256": "00ed529a30f8458abb6580d8672e529443e30ca8741a90bda07d2153fad821f4",
                    "outputSha256": "022438b15adb78e88f4cbcea2f92851f0f87f5b974e69d887628681ed5ad10d1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-contract-negative-cases": {
      "post": {
        "operationId": "x402_json_contract_negative_cases",
        "summary": "Targeted JSON contract negative fixture composer",
        "description": "Compose invalid payloads from a caller-supplied valid seed with one structural edit, an exact target assertion and the complete bounded failed-assertion set.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-contract-negative-cases.md"
        },
        "x-agent-discovery": {
          "intents": [
            "generate targeted negative request payloads from a valid JSON seed and supported schema",
            "compose one-edit contract violations with checked constraint isolation"
          ],
          "whenToUse": [
            "generate targeted negative request payloads from a valid JSON seed and supported schema",
            "compose one-edit contract violations with checked constraint isolation"
          ],
          "whenNotToUse": [
            "Target rejection guarantees, expected HTTP status, fuzz attacks or a mutation-testing score",
            "A valid seed is missing or incompatible with the supported structural schema",
            "Arbitrary JSON Schema, formats, regexes, references, combinators, nested objects or nested arrays",
            "Executing target tests, fetching services, running supplied code or proving security"
          ],
          "capabilities": [
            "Caller-supplied seed works independently of the valid-fixture tool",
            "One inert JSON Patch per generated case, explicit assertion identities and complete failed-assertion manifests",
            "requireIsolated suppresses fixtures with additional failures; unavailable requests have explicit reasons",
            "Closed constructive-json-schema-v1 profile; unsupported keywords are rejected rather than ignored",
            "Networkless deterministic supplied-data computation; no target behavior or full input-space coverage claim",
            "Atomic complete bounded computation before the payment challenge; no partial packet on resource overflow"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "inputNodes": 12000,
            "outputNodes": 50000,
            "depth": 16,
            "schemaNodes": 80,
            "properties": 32,
            "enumMembers": 16,
            "arrayItems": 16,
            "stringLength": 256,
            "fixtures": 128,
            "goals": 512,
            "mutations": 64,
            "validatorNodeVisits": 50000,
            "candidateBytes": 2000000,
            "jsonNodes": 12000,
            "profile": "constructive-json-schema-v1"
          },
          "related": [
            "json-schema-fixtures-compose",
            "json-schema-check",
            "json-patch"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "UNSUPPORTED_SCHEMA",
            "INVALID_SCHEMA",
            "SCHEMA_LIMIT",
            "WORK_LIMIT",
            "GOAL_LIMIT",
            "FIXTURE_LIMIT",
            "SEED_LIMIT",
            "INVALID_SEED",
            "DUPLICATE_ID",
            "INVALID_POINTER",
            "MUTATION_LIMIT",
            "INTERNAL_INVARIANT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "schema": {
                    "$ref": "#/paths/~1v1~1x402~1json-contract-negative-cases/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "seed": {
                    "$ref": "#/paths/~1v1~1x402~1json-contract-negative-cases/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "mutations": {
                    "minItems": 1,
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 1024
                            },
                            "requireIsolated": {
                              "default": false,
                              "type": "boolean"
                            },
                            "kind": {
                              "type": "string",
                              "enum": [
                                "removeRequired",
                                "belowMinimum",
                                "aboveMaximum",
                                "shortenString",
                                "lengthenString",
                                "shortenArray",
                                "lengthenArray"
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "path",
                            "kind"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 1024
                            },
                            "requireIsolated": {
                              "default": false,
                              "type": "boolean"
                            },
                            "kind": {
                              "type": "string",
                              "const": "replaceType"
                            },
                            "replacementType": {
                              "type": "string",
                              "enum": [
                                "null",
                                "boolean",
                                "integer",
                                "number",
                                "string",
                                "array",
                                "object"
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "path",
                            "kind",
                            "replacementType"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 1024
                            },
                            "requireIsolated": {
                              "default": false,
                              "type": "boolean"
                            },
                            "kind": {
                              "type": "string",
                              "const": "outsideEnum"
                            },
                            "value": {
                              "anyOf": [
                                {
                                  "type": "null"
                                },
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "number"
                                },
                                {
                                  "type": "string",
                                  "maxLength": 1024
                                }
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "path",
                            "kind",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 1024
                            },
                            "requireIsolated": {
                              "default": false,
                              "type": "boolean"
                            },
                            "kind": {
                              "type": "string",
                              "const": "addProperty"
                            },
                            "name": {
                              "type": "string",
                              "maxLength": 128
                            }
                          },
                          "required": [
                            "id",
                            "path",
                            "kind",
                            "name"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "schema",
                  "seed",
                  "mutations"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-contract-negative-cases/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-contract-negative-cases/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "schema": {
                  "type": "object",
                  "required": [
                    "count",
                    "mode"
                  ],
                  "properties": {
                    "count": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 3
                    },
                    "mode": {
                      "type": "string",
                      "enum": [
                        "fast",
                        "safe"
                      ]
                    }
                  },
                  "additionalProperties": false
                },
                "seed": {
                  "count": 1,
                  "mode": "fast"
                },
                "mutations": [
                  {
                    "id": "missing",
                    "kind": "removeRequired",
                    "path": "/count",
                    "requireIsolated": true
                  },
                  {
                    "id": "small",
                    "kind": "belowMinimum",
                    "path": "/count",
                    "requireIsolated": true
                  },
                  {
                    "id": "large",
                    "kind": "aboveMaximum",
                    "path": "/count",
                    "requireIsolated": true
                  },
                  {
                    "id": "enum",
                    "kind": "outsideEnum",
                    "path": "/mode",
                    "value": "other",
                    "requireIsolated": true
                  },
                  {
                    "id": "extra",
                    "kind": "addProperty",
                    "path": "",
                    "name": "extra",
                    "requireIsolated": true
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-contract-negative-cases",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "constructive-json-schema-v1"
                        },
                        "status": {
                          "type": "string",
                          "const": "complete"
                        },
                        "cases": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "generated",
                                  "unavailable"
                                ]
                              },
                              "value": {
                                "$ref": "#/paths/~1v1~1x402~1json-contract-negative-cases/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              },
                              "patch": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "op": {
                                            "type": "string",
                                            "const": "remove"
                                          },
                                          "path": {
                                            "type": "string"
                                          }
                                        },
                                        "required": [
                                          "op",
                                          "path"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "op": {
                                            "type": "string",
                                            "enum": [
                                              "add",
                                              "replace"
                                            ]
                                          },
                                          "path": {
                                            "type": "string"
                                          },
                                          "value": {
                                            "$ref": "#/paths/~1v1~1x402~1json-contract-negative-cases/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                          }
                                        },
                                        "required": [
                                          "op",
                                          "path",
                                          "value"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "target": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "keyword": {
                                        "type": "string",
                                        "enum": [
                                          "type",
                                          "const",
                                          "enum",
                                          "minimum",
                                          "maximum",
                                          "minLength",
                                          "maxLength",
                                          "minItems",
                                          "maxItems",
                                          "required",
                                          "additionalProperties"
                                        ]
                                      },
                                      "schemaPath": {
                                        "type": "string"
                                      },
                                      "instancePath": {
                                        "type": "string"
                                      },
                                      "property": {
                                        "type": [
                                          "string",
                                          "null"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "keyword",
                                      "schemaPath",
                                      "instancePath",
                                      "property"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "failures": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "keyword": {
                                      "type": "string",
                                      "enum": [
                                        "type",
                                        "const",
                                        "enum",
                                        "minimum",
                                        "maximum",
                                        "minLength",
                                        "maxLength",
                                        "minItems",
                                        "maxItems",
                                        "required",
                                        "additionalProperties"
                                      ]
                                    },
                                    "schemaPath": {
                                      "type": "string"
                                    },
                                    "instancePath": {
                                      "type": "string"
                                    },
                                    "property": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "keyword",
                                    "schemaPath",
                                    "instancePath",
                                    "property"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "isolated": {
                                "type": [
                                  "boolean",
                                  "null"
                                ]
                              },
                              "reason": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "kind",
                              "status",
                              "patch",
                              "target",
                              "failures",
                              "isolated",
                              "reason"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "testing": {
                          "type": "object",
                          "properties": {
                            "targetExecuted": {
                              "type": "boolean",
                              "const": false
                            },
                            "behaviorVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "fullInputSpaceCoverage": {
                              "type": "boolean",
                              "const": false
                            }
                          },
                          "required": [
                            "targetExecuted",
                            "behaviorVerified",
                            "fullInputSpaceCoverage"
                          ],
                          "additionalProperties": false
                        },
                        "metrics": {
                          "type": "object",
                          "properties": {
                            "schemaNodes": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "validatorNodeVisits": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "schemaNodes",
                            "validatorNodeVisits"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "cases",
                        "testing",
                        "metrics"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1json-contract-negative-cases/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1json-contract-negative-cases/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-contract-negative-cases",
                  "version": "0.29.0",
                  "result": {
                    "profile": "constructive-json-schema-v1",
                    "status": "complete",
                    "cases": [
                      {
                        "id": "missing",
                        "kind": "removeRequired",
                        "status": "generated",
                        "value": {
                          "mode": "fast"
                        },
                        "patch": {
                          "op": "remove",
                          "path": "/count"
                        },
                        "target": {
                          "keyword": "required",
                          "schemaPath": "/required/0",
                          "instancePath": "",
                          "property": "count"
                        },
                        "failures": [
                          {
                            "keyword": "required",
                            "schemaPath": "/required/0",
                            "instancePath": "",
                            "property": "count"
                          }
                        ],
                        "isolated": true,
                        "reason": null
                      },
                      {
                        "id": "small",
                        "kind": "belowMinimum",
                        "status": "generated",
                        "value": {
                          "count": 0,
                          "mode": "fast"
                        },
                        "patch": {
                          "op": "replace",
                          "path": "/count",
                          "value": 0
                        },
                        "target": {
                          "keyword": "minimum",
                          "schemaPath": "/properties/count/minimum",
                          "instancePath": "/count",
                          "property": null
                        },
                        "failures": [
                          {
                            "keyword": "minimum",
                            "schemaPath": "/properties/count/minimum",
                            "instancePath": "/count",
                            "property": null
                          }
                        ],
                        "isolated": true,
                        "reason": null
                      },
                      {
                        "id": "large",
                        "kind": "aboveMaximum",
                        "status": "generated",
                        "value": {
                          "count": 4,
                          "mode": "fast"
                        },
                        "patch": {
                          "op": "replace",
                          "path": "/count",
                          "value": 4
                        },
                        "target": {
                          "keyword": "maximum",
                          "schemaPath": "/properties/count/maximum",
                          "instancePath": "/count",
                          "property": null
                        },
                        "failures": [
                          {
                            "keyword": "maximum",
                            "schemaPath": "/properties/count/maximum",
                            "instancePath": "/count",
                            "property": null
                          }
                        ],
                        "isolated": true,
                        "reason": null
                      },
                      {
                        "id": "enum",
                        "kind": "outsideEnum",
                        "status": "generated",
                        "value": {
                          "count": 1,
                          "mode": "other"
                        },
                        "patch": {
                          "op": "replace",
                          "path": "/mode",
                          "value": "other"
                        },
                        "target": {
                          "keyword": "enum",
                          "schemaPath": "/properties/mode/enum",
                          "instancePath": "/mode",
                          "property": null
                        },
                        "failures": [
                          {
                            "keyword": "enum",
                            "schemaPath": "/properties/mode/enum",
                            "instancePath": "/mode",
                            "property": null
                          }
                        ],
                        "isolated": true,
                        "reason": null
                      },
                      {
                        "id": "extra",
                        "kind": "addProperty",
                        "status": "generated",
                        "value": {
                          "count": 1,
                          "mode": "fast",
                          "extra": null
                        },
                        "patch": {
                          "op": "add",
                          "path": "/extra",
                          "value": null
                        },
                        "target": {
                          "keyword": "additionalProperties",
                          "schemaPath": "/additionalProperties",
                          "instancePath": "",
                          "property": "extra"
                        },
                        "failures": [
                          {
                            "keyword": "additionalProperties",
                            "schemaPath": "/additionalProperties",
                            "instancePath": "",
                            "property": "extra"
                          }
                        ],
                        "isolated": true,
                        "reason": null
                      }
                    ],
                    "testing": {
                      "targetExecuted": false,
                      "behaviorVerified": false,
                      "fullInputSpaceCoverage": false
                    },
                    "metrics": {
                      "schemaNodes": 3,
                      "validatorNodeVisits": 17
                    }
                  },
                  "provenance": {
                    "inputSha256": "92b1781c5d4fb22662c0f3b12949608d22c2d3049848b4f4578d94b179aebd08",
                    "outputSha256": "c7d676c4af4f285bf4b45d99110910f7d394a6bdf6c8490543577d7cc0651ac9",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/cbor-typed-codec": {
      "post": {
        "operationId": "x402_cbor_typed_codec",
        "summary": "Typed deterministic CBOR codec",
        "description": "Encode typed values or decode a strictly admitted core-deterministic CBOR integer subset with bounded tokens and exact integer precision.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/cbor-typed-codec.md"
        },
        "x-agent-discovery": {
          "intents": [
            "encode deterministic CBOR",
            "decode typed CBOR",
            "preserve exact CBOR integers and bytes",
            "inspect bounded core deterministic CBOR"
          ],
          "whenToUse": [
            "A declared consumer requires this specific binary format and exact integer/binary distinctions",
            "Create a bounded offline configuration or protocol fixture from supplied typed values"
          ],
          "whenNotToUse": [
            "Floating point, dates, timestamp/tag extensions, missing-value primitives, custom objects, streaming or arbitrary maps",
            "General CBOR, tags, indefinite lengths, unsorted keys or nonpreferred encodings",
            "Legacy length-first CBOR map ordering or dCBOR normalization",
            "Network transport, authentication, signatures, COSE/CWT/WebAuthn, consumer schema validation, or execution of decoded content"
          ],
          "capabilities": [
            "Canonical decimal input strings preserve the full profile integer domain",
            "Unicode scalar text and strict canonical standard padded base64",
            "Duplicate typed keys rejected; text and byte strings remain distinct",
            "Complete semantic computation and result admission before payment challenge and again during execution",
            "Networkless deterministic supplied-input-only artifacts; externalRequests=0",
            "RFC 8949 core bytewise key order; lazy upstream tokens with budgets before materialization, exact one-item consumption and byte-equality re-encoding"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "jsonDepth": 20,
            "wireBytes": 40000,
            "contentBytes": 32768,
            "valueNodes": 1024,
            "arrayItems": 512,
            "mapPairs": 128,
            "valueDepth": 5,
            "cborKeyBytes": 128,
            "messagepackKeyBytes": 64,
            "profile": "cbor-core-deterministic-integer-v1",
            "actions": "encode,decode",
            "integerMinimum": "-18446744073709551616",
            "integerMaximum": "18446744073709551615",
            "mapKeys": "Typed integers or scalar text <=128 UTF-8 bytes; reserved text names rejected",
            "determinismScope": "RFC8949-core-subset"
          },
          "related": [
            "messagepack-compose",
            "protobuf-message-compose",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INTEGER",
            "INTEGER_RANGE",
            "INVALID_KEY",
            "DUPLICATE_KEY",
            "INVALID_ENCODING",
            "UNSUPPORTED_TYPE",
            "NONDETERMINISTIC_ENCODING",
            "ENCODING_MISMATCH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "action": {
                        "type": "string",
                        "const": "encode"
                      },
                      "value": {
                        "$ref": "#/paths/~1v1~1x402~1cbor-typed-codec/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    },
                    "required": [
                      "action",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "action": {
                        "type": "string",
                        "const": "decode"
                      },
                      "base64": {
                        "type": "string",
                        "maxLength": 53336
                      }
                    },
                    "required": [
                      "action",
                      "base64"
                    ],
                    "additionalProperties": false
                  }
                ],
                "$defs": {
                  "__schema0": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "null"
                          }
                        },
                        "required": [
                          "type"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "boolean"
                          },
                          "value": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "integer"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 21
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "text"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 32768
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "bytes"
                          },
                          "base64": {
                            "type": "string",
                            "maxLength": 43692
                          }
                        },
                        "required": [
                          "type",
                          "base64"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "array"
                          },
                          "items": {
                            "maxItems": 512,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1x402~1cbor-typed-codec/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          }
                        },
                        "required": [
                          "type",
                          "items"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "map"
                          },
                          "entries": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "integer"
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 21
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "text"
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 32768
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  ]
                                },
                                "value": {
                                  "$ref": "#/paths/~1v1~1x402~1cbor-typed-codec/post/requestBody/content/application~1json/schema/$defs/__schema0"
                                }
                              },
                              "required": [
                                "key",
                                "value"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "type",
                          "entries"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                }
              },
              "example": {
                "action": "encode",
                "value": {
                  "type": "map",
                  "entries": [
                    {
                      "key": {
                        "type": "integer",
                        "value": "24"
                      },
                      "value": {
                        "type": "text",
                        "value": "x"
                      }
                    },
                    {
                      "key": {
                        "type": "integer",
                        "value": "-1"
                      },
                      "value": {
                        "type": "text",
                        "value": "y"
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "cbor-typed-codec",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "cbor-core-deterministic-integer-v1"
                            },
                            "action": {
                              "type": "string",
                              "const": "encode"
                            },
                            "base64": {
                              "type": "string",
                              "maxLength": 53336
                            },
                            "byteLength": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 40000
                            },
                            "valueCount": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 1024
                            },
                            "maxValueDepth": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 5
                            },
                            "deterministic": {
                              "type": "boolean",
                              "const": true
                            }
                          },
                          "required": [
                            "profile",
                            "action",
                            "base64",
                            "byteLength",
                            "valueCount",
                            "maxValueDepth",
                            "deterministic"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "cbor-core-deterministic-integer-v1"
                            },
                            "action": {
                              "type": "string",
                              "const": "decode"
                            },
                            "value": {
                              "$ref": "#/paths/~1v1~1x402~1cbor-typed-codec/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            },
                            "byteLength": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 40000
                            },
                            "valueCount": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 1024
                            },
                            "maxValueDepth": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 5
                            },
                            "deterministic": {
                              "type": "boolean",
                              "const": true
                            }
                          },
                          "required": [
                            "profile",
                            "action",
                            "value",
                            "byteLength",
                            "valueCount",
                            "maxValueDepth",
                            "deterministic"
                          ],
                          "additionalProperties": false
                        }
                      ],
                      "$defs": {
                        "__schema0": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "null"
                                }
                              },
                              "required": [
                                "type"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "boolean"
                                },
                                "value": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "type",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "integer"
                                },
                                "value": {
                                  "type": "string",
                                  "maxLength": 21
                                }
                              },
                              "required": [
                                "type",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "text"
                                },
                                "value": {
                                  "type": "string",
                                  "maxLength": 32768
                                }
                              },
                              "required": [
                                "type",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "bytes"
                                },
                                "base64": {
                                  "type": "string",
                                  "maxLength": 43692
                                }
                              },
                              "required": [
                                "type",
                                "base64"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "array"
                                },
                                "items": {
                                  "maxItems": 512,
                                  "type": "array",
                                  "items": {
                                    "$ref": "#/paths/~1v1~1x402~1cbor-typed-codec/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                }
                              },
                              "required": [
                                "type",
                                "items"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "map"
                                },
                                "entries": {
                                  "maxItems": 128,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "key": {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "type": {
                                                "type": "string",
                                                "const": "integer"
                                              },
                                              "value": {
                                                "type": "string",
                                                "maxLength": 21
                                              }
                                            },
                                            "required": [
                                              "type",
                                              "value"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "type": {
                                                "type": "string",
                                                "const": "text"
                                              },
                                              "value": {
                                                "type": "string",
                                                "maxLength": 32768
                                              }
                                            },
                                            "required": [
                                              "type",
                                              "value"
                                            ],
                                            "additionalProperties": false
                                          }
                                        ]
                                      },
                                      "value": {
                                        "$ref": "#/paths/~1v1~1x402~1cbor-typed-codec/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                      }
                                    },
                                    "required": [
                                      "key",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  }
                                }
                              },
                              "required": [
                                "type",
                                "entries"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "cbor-typed-codec",
                  "version": "0.29.0",
                  "result": {
                    "profile": "cbor-core-deterministic-integer-v1",
                    "action": "encode",
                    "base64": "ohgYYXggYXk=",
                    "byteLength": 8,
                    "valueCount": 5,
                    "maxValueDepth": 1,
                    "deterministic": true
                  },
                  "provenance": {
                    "inputSha256": "7b9af4d66effddb96c02ddd45a9d116696f260b408666efb5c2359edfca7a086",
                    "outputSha256": "4178363f71c33a301c6ad2e9d333d706e7ddcd0a1a772cd6f1a9fa8e7b559ee1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/messagepack-compose": {
      "post": {
        "operationId": "x402_messagepack_compose",
        "summary": "Typed MessagePack composer",
        "description": "Compose stable MessagePack bytes from typed integers, text, binary, arrays and restricted-key maps; exact uint64/int64, encode only.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/messagepack-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compose typed MessagePack",
            "encode exact int64 uint64 MessagePack",
            "create MessagePack binary record",
            "serialize typed binary payload"
          ],
          "whenToUse": [
            "A declared consumer requires this specific binary format and exact integer/binary distinctions",
            "Create a bounded offline configuration or protocol fixture from supplied typed values"
          ],
          "whenNotToUse": [
            "Floating point, dates, timestamp/tag extensions, missing-value primitives, custom objects, streaming or arbitrary maps",
            "Decode or inspect MessagePack bytes; decoding is explicitly held",
            "A universal MessagePack canonical form",
            "Network transport, authentication, signatures, COSE/CWT/WebAuthn, consumer schema validation, or execution of decoded content"
          ],
          "capabilities": [
            "Canonical decimal input strings preserve the full profile integer domain",
            "Unicode scalar text and strict canonical standard padded base64",
            "Duplicate typed keys rejected; text and byte strings remain distinct",
            "Complete semantic computation and result admission before payment challenge and again during execution",
            "Networkless deterministic supplied-input-only artifacts; externalRequests=0",
            "Service-defined stable ASCII-key ordering and shortest admitted wire forms; encode only"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "jsonDepth": 20,
            "wireBytes": 40000,
            "contentBytes": 32768,
            "valueNodes": 1024,
            "arrayItems": 512,
            "mapPairs": 128,
            "valueDepth": 5,
            "cborKeyBytes": 128,
            "messagepackKeyBytes": 64,
            "profile": "messagepack-stable-integer-v1",
            "actions": "encode",
            "integerMinimum": "-9223372036854775808",
            "integerMaximum": "18446744073709551615",
            "mapKeys": "ASCII text [A-Za-z_][A-Za-z0-9_.-]{0,63}; reserved names rejected",
            "determinismScope": "this-profile-only"
          },
          "related": [
            "cbor-typed-codec",
            "protobuf-message-compose",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INTEGER",
            "INTEGER_RANGE",
            "INVALID_KEY",
            "DUPLICATE_KEY",
            "INVALID_ENCODING",
            "UNSUPPORTED_TYPE",
            "NONDETERMINISTIC_ENCODING",
            "ENCODING_MISMATCH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string",
                    "const": "encode"
                  },
                  "value": {
                    "$ref": "#/paths/~1v1~1x402~1messagepack-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "action",
                  "value"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "null"
                          }
                        },
                        "required": [
                          "type"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "boolean"
                          },
                          "value": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "integer"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 21
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "text"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 32768
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "bytes"
                          },
                          "base64": {
                            "type": "string",
                            "maxLength": 43692
                          }
                        },
                        "required": [
                          "type",
                          "base64"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "array"
                          },
                          "items": {
                            "maxItems": 512,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1x402~1messagepack-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          }
                        },
                        "required": [
                          "type",
                          "items"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "map"
                          },
                          "entries": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "integer"
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 21
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "text"
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 32768
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  ]
                                },
                                "value": {
                                  "$ref": "#/paths/~1v1~1x402~1messagepack-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                                }
                              },
                              "required": [
                                "key",
                                "value"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "type",
                          "entries"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                }
              },
              "example": {
                "action": "encode",
                "value": {
                  "type": "map",
                  "entries": [
                    {
                      "key": {
                        "type": "text",
                        "value": "id"
                      },
                      "value": {
                        "type": "integer",
                        "value": "18446744073709551615"
                      }
                    },
                    {
                      "key": {
                        "type": "text",
                        "value": "blob"
                      },
                      "value": {
                        "type": "bytes",
                        "base64": "AP8="
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "messagepack-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "messagepack-stable-integer-v1"
                        },
                        "action": {
                          "type": "string",
                          "const": "encode"
                        },
                        "base64": {
                          "type": "string",
                          "maxLength": 53336
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 40000
                        },
                        "valueCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1024
                        },
                        "maxValueDepth": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 5
                        },
                        "determinismScope": {
                          "type": "string",
                          "const": "this-profile-only"
                        }
                      },
                      "required": [
                        "profile",
                        "action",
                        "base64",
                        "byteLength",
                        "valueCount",
                        "maxValueDepth",
                        "determinismScope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "messagepack-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "messagepack-stable-integer-v1",
                    "action": "encode",
                    "base64": "gqRibG9ixAIA/6JpZM///////////w==",
                    "byteLength": 22,
                    "valueCount": 5,
                    "maxValueDepth": 1,
                    "determinismScope": "this-profile-only"
                  },
                  "provenance": {
                    "inputSha256": "a4ad025cad1b5ebe3f64d20dac6c26256b62901557a7a6b725a6f08919914302",
                    "outputSha256": "d3c9928e42a45e1b8a879ed97400b790571dc529da0d3a483f238db6067743f4",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/toml-config-compose": {
      "post": {
        "operationId": "x402_toml_config_compose",
        "summary": "Typed TOML configuration composer",
        "description": "Compose deterministic TOML 1.0-compatible configuration from explicit string, signed-int64, boolean and homogeneous-array declarations; preserve integer precision and detect table conflicts.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/toml-config-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compose typed TOML configuration",
            "generate TOML with exact int64 values",
            "serialize homogeneous arrays and nested TOML tables",
            "detect TOML table scalar conflicts"
          ],
          "whenToUse": [
            "Creating new TOML 1.0-compatible files from explicit typed declarations",
            "Preserving full signed-int64 precision without JavaScript numeric conversion",
            "Producing an inert exact-byte configuration artifact for an offline consumer"
          ],
          "whenNotToUse": [
            "Parsing, merging or editing existing TOML source or preserving comments",
            "Floating-point values, dates, times, null, nested or mixed arrays, arrays of tables or inline tables",
            "Application configuration validation, interpolation, environment expansion, filesystem includes or secret classification",
            "Network requests, writing files, live configuration changes, authentication, publishing or deployment"
          ],
          "capabilities": [
            "Profile toml-1.0-typed-config-v1; quoted basic-string keys; UTF-16 ordinal ordering with parents first",
            "Signed-int64 decimal strings; typed homogeneous primitive arrays; Unicode scalar strings",
            "Duplicate table/key and scalar/table-ancestor conflict rejection; exact key segments including literal dots",
            "LF line endings and final LF for nonempty output; empty root produces the empty document",
            "Deterministic supplied-input-only artifact; no network, clock or randomness",
            "Exact artifact UTF-8 byte lengths and SHA-256 hashes"
          ],
          "related": [
            "zip-store-compose",
            "json-schema-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 20,
            "tables": 128,
            "entries": 512,
            "tablePathSegments": 4,
            "keyUtf8Bytes": 128,
            "arrayCells": 256,
            "aggregateCells": 2048,
            "stringValueUtf8Bytes": 32768,
            "artifactUtf8Bytes": 100000,
            "profile": "toml-1.0-typed-config-v1"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "INVALID_INPUT",
            "UNSAFE_KEY",
            "TOML_INTEGER",
            "TOML_KEY_LIMIT",
            "TOML_DUPLICATE_TABLE",
            "TOML_ENTRY_LIMIT",
            "TOML_CELL_LIMIT",
            "TOML_ARRAY_TYPE",
            "TOML_STRING_LIMIT",
            "TOML_DUPLICATE_KEY",
            "TOML_TABLE_CONFLICT",
            "TOML_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "tables": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 128
                          }
                        },
                        "entries": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string",
                                "maxLength": 128
                              },
                              "value": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "string"
                                      },
                                      "value": {
                                        "type": "string",
                                        "maxLength": 32768
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "integer"
                                      },
                                      "value": {
                                        "type": "string",
                                        "maxLength": 20
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "boolean"
                                      },
                                      "value": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "array"
                                      },
                                      "elementType": {
                                        "type": "string",
                                        "enum": [
                                          "string",
                                          "integer",
                                          "boolean"
                                        ]
                                      },
                                      "values": {
                                        "maxItems": 256,
                                        "type": "array",
                                        "items": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "maxLength": 32768
                                            },
                                            {
                                              "type": "boolean"
                                            }
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "elementType",
                                      "values"
                                    ],
                                    "additionalProperties": false
                                  }
                                ]
                              }
                            },
                            "required": [
                              "key",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "path",
                        "entries"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "tables"
                ],
                "additionalProperties": false
              },
              "example": {
                "tables": [
                  {
                    "path": [
                      "server"
                    ],
                    "entries": [
                      {
                        "key": "port",
                        "value": {
                          "type": "integer",
                          "value": "8080"
                        }
                      },
                      {
                        "key": "enabled",
                        "value": {
                          "type": "boolean",
                          "value": true
                        }
                      },
                      {
                        "key": "name",
                        "value": {
                          "type": "string",
                          "value": "café"
                        }
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "toml-config-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "toml-1.0-typed-config-v1"
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "tableCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 128
                        },
                        "entryCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 512
                        }
                      },
                      "required": [
                        "profile",
                        "text",
                        "byteLength",
                        "sha256",
                        "tableCount",
                        "entryCount"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "toml-config-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "toml-1.0-typed-config-v1",
                    "text": "[\"server\"]\n\"enabled\" = true\n\"name\" = \"café\"\n\"port\" = 8080\n",
                    "byteLength": 59,
                    "sha256": "87bc7526e622cadc468e1870a97859ccc52909d2419e07064af6162e22a99d35",
                    "tableCount": 1,
                    "entryCount": 3
                  },
                  "provenance": {
                    "inputSha256": "fe94f7a66d0e2d6a9ea149fd1123d7e3673ab90b272e1a4b855a7683f273e4da",
                    "outputSha256": "050fb9b266805cf67ae8e4a0d458b3b89cd5424fe22ae1e866475934ef7d3f6f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/http-structured-fields-compose": {
      "post": {
        "operationId": "x402_http_structured_fields_compose",
        "summary": "Typed HTTP structured-field composer",
        "description": "Compose separate exact RFC 8941-compatible structured field values from explicit typed Items, Lists and Dictionaries; preserve decimal types without floating-point rounding.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-structured-fields-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compose typed HTTP structured fields",
            "serialize RFC 8941 items lists dictionaries",
            "preserve HTTP structured decimal and integer distinction",
            "prepare offline structured header field fixtures"
          ],
          "whenToUse": [
            "Composing caller-declared structured field name/value pairs for offline protocol fixtures",
            "Preserving ordered dictionaries and parameters with explicit string/token/bytes/integer/decimal/boolean types",
            "Rejecting decimal rounding, injection and duplicate keys before handoff"
          ],
          "whenNotToUse": [
            "Parsing existing fields, combining repeated lines or normalizing arbitrary headers",
            "Full RFC 9651 Date and Display String types; this explicit RFC 8941 vocabulary profile excludes them",
            "HTTP Message Signatures, signing, digest verification, authentication, cookies, header policy or application field semantics",
            "Raw HTTP header blocks, requests or transmission",
            "Network requests, writing files, live configuration changes, authentication, publishing or deployment"
          ],
          "capabilities": [
            "Profile http-sf-rfc8941-compose-v1; RFC 9651 supersedes RFC 8941 without silently expanding this vocabulary",
            "Exact decimal-string formatting without rounding; signed zero normalized within its selected integer or decimal type",
            "Preserved field, dictionary and parameter order; boolean-true elision; padded canonical base64",
            "Empty List/Dictionary returns omitted true and null value/hash; caller must omit that field",
            "Deterministic supplied-input-only artifact; no network, clock or randomness",
            "Exact artifact UTF-8 byte lengths and SHA-256 hashes"
          ],
          "related": [
            "content-digest",
            "json-schema-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 20,
            "fields": 16,
            "fieldValueBytes": 8192,
            "totalValueBytes": 16384,
            "topLevelMembers": 128,
            "innerListItems": 32,
            "parameters": 16,
            "bareItems": 512,
            "keyAsciiBytes": 64,
            "tokenBytes": 256,
            "stringBytes": 1024,
            "decodedByteValueBytes": 2048,
            "profile": "http-sf-rfc8941-compose-v1"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "INVALID_INPUT",
            "UNSAFE_KEY",
            "SF_KEY",
            "SF_ITEM_LIMIT",
            "SF_INTEGER",
            "SF_DECIMAL",
            "SF_STRING",
            "SF_TOKEN",
            "SF_BYTES",
            "SF_BYTES_LIMIT",
            "SF_DUPLICATE_KEY",
            "SF_FIELD_NAME",
            "SF_DUPLICATE_FIELD",
            "SF_FIELD_LIMIT",
            "SF_TOTAL_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "fields": {
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                    }
                  }
                },
                "required": [
                  "fields"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          },
                          "kind": {
                            "type": "string",
                            "const": "item"
                          },
                          "value": {
                            "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema1"
                          }
                        },
                        "required": [
                          "name",
                          "kind",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          },
                          "kind": {
                            "type": "string",
                            "const": "list"
                          },
                          "value": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema5"
                            }
                          }
                        },
                        "required": [
                          "name",
                          "kind",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          },
                          "kind": {
                            "type": "string",
                            "const": "dictionary"
                          },
                          "value": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema6"
                            }
                          }
                        },
                        "required": [
                          "name",
                          "kind",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "__schema1": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "const": "item"
                      },
                      "value": {
                        "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema2"
                      },
                      "parameters": {
                        "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema3"
                      }
                    },
                    "required": [
                      "kind",
                      "value",
                      "parameters"
                    ],
                    "additionalProperties": false
                  },
                  "__schema2": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "integer"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 16
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "decimal"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 17
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "string"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 1024
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "token"
                          },
                          "value": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 256
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "bytes"
                          },
                          "base64": {
                            "type": "string",
                            "maxLength": 2732
                          }
                        },
                        "required": [
                          "type",
                          "base64"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "boolean"
                          },
                          "value": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "__schema3": {
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema4"
                    }
                  },
                  "__schema4": {
                    "type": "object",
                    "properties": {
                      "key": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 64
                      },
                      "value": {
                        "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema2"
                      }
                    },
                    "required": [
                      "key",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  "__schema5": {
                    "anyOf": [
                      {
                        "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema1"
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "inner-list"
                          },
                          "items": {
                            "maxItems": 32,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema1"
                            }
                          },
                          "parameters": {
                            "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema3"
                          }
                        },
                        "required": [
                          "kind",
                          "items",
                          "parameters"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "__schema6": {
                    "type": "object",
                    "properties": {
                      "key": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 64
                      },
                      "value": {
                        "$ref": "#/paths/~1v1~1x402~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema5"
                      }
                    },
                    "required": [
                      "key",
                      "value"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "example": {
                "fields": [
                  {
                    "name": "example-field",
                    "kind": "dictionary",
                    "value": [
                      {
                        "key": "demo",
                        "value": {
                          "kind": "inner-list",
                          "items": [
                            {
                              "kind": "item",
                              "value": {
                                "type": "string",
                                "value": "@method"
                              },
                              "parameters": []
                            },
                            {
                              "kind": "item",
                              "value": {
                                "type": "string",
                                "value": "@path"
                              },
                              "parameters": []
                            }
                          ],
                          "parameters": [
                            {
                              "key": "created",
                              "value": {
                                "type": "integer",
                                "value": "1700000000"
                              }
                            },
                            {
                              "key": "keyid",
                              "value": {
                                "type": "string",
                                "value": "test-key"
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-structured-fields-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-sf-rfc8941-compose-v1"
                        },
                        "fields": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "item",
                                  "list",
                                  "dictionary"
                                ]
                              },
                              "value": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 8192
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "byteLength": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8192
                              },
                              "sha256": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "pattern": "^[a-f0-9]{64}$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "omitted": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "name",
                              "kind",
                              "value",
                              "byteLength",
                              "sha256",
                              "omitted"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "totalValueBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 16384
                        }
                      },
                      "required": [
                        "profile",
                        "fields",
                        "totalValueBytes"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-structured-fields-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-sf-rfc8941-compose-v1",
                    "fields": [
                      {
                        "name": "example-field",
                        "kind": "dictionary",
                        "value": "demo=(\"@method\" \"@path\");created=1700000000;keyid=\"test-key\"",
                        "byteLength": 60,
                        "sha256": "9549594186c7d71f2acc27b9af7465a6e8702825b92cc5d7a196a689a83f256a",
                        "omitted": false
                      }
                    ],
                    "totalValueBytes": 60
                  },
                  "provenance": {
                    "inputSha256": "cb932c2bbf36d20dfa385ebc42387e41d8319f351e288e39c4a77589a100fd87",
                    "outputSha256": "6dbcf72ffb8b18b3d6fdc44a3a79541f0f2b2134575242028789cb33f8823e8f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-sample-shape-infer": {
      "post": {
        "operationId": "x402_json_sample_shape_infer",
        "summary": "Observed JSON sample shapes",
        "description": "Build an optional, open observational JSON Schema draft and counted evidence from supplied JSON samples; never infer a real API contract.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-sample-shape-infer.md"
        },
        "x-agent-discovery": {
          "intents": [
            "infer observational schema from JSON samples",
            "draft sampled JSON structure",
            "count recursive observed types"
          ],
          "whenToUse": [
            "Review a recursive open schema draft inferred from bounded supplied examples",
            "Inspect sample counts, optional properties and unobserved empty-array items"
          ],
          "whenNotToUse": [
            "Establishing a universal API contract or production rejection policy",
            "Inferring required fields, enums, formats, ranges, cross-field correlations or compatibility",
            "Generating a tool definition or assuming generalized fixture-generator compatibility",
            "Network access, filesystem changes, target execution, publishing or deployment"
          ],
          "capabilities": [
            "Fixed null, boolean, number, string, array, object union order using anyOf",
            "All observed numbers emit number; object properties stay optional and additionalProperties stays true",
            "Actual escaped schema pointers identify pooled observations; empty items emit true with zero counts",
            "No required, enum, const, bounds, patterns, formats, defaults, references or closed objects",
            "Pure supplied-input computation; complete bounded result admission before challenge; no external requests"
          ],
          "related": [
            "record-profile",
            "json-schema-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "samples": 64,
            "sourceNodes": 5000,
            "semanticDepth": 8,
            "pooledObjectKeys": 32,
            "observationLocations": 128,
            "emittedSchemaNodes": 180,
            "schemaValidationDepth": 16,
            "schemaRepresentationDepth": 20,
            "keyBytes": 96,
            "aggregateSourceKeyBytes": 64000,
            "aggregateSchemaPointerBytes": 32768,
            "nodeVisits": 5000
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SHAPE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "samples": {
                    "minItems": 1,
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "$ref": "#/paths/~1v1~1x402~1json-sample-shape-infer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                    }
                  }
                },
                "required": [
                  "samples"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1json-sample-shape-infer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1json-sample-shape-infer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "samples": [
                  {
                    "id": 1,
                    "tag": "a",
                    "tags": []
                  },
                  {
                    "id": 2,
                    "tag": null,
                    "tags": [
                      "x"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-sample-shape-infer",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "observed-json-shapes-v1"
                        },
                        "evidence": {
                          "type": "string",
                          "const": "observed-structure-only"
                        },
                        "contractEstablished": {
                          "type": "boolean",
                          "const": false
                        },
                        "sampleCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 64
                        },
                        "dialect": {
                          "type": "string",
                          "const": "https://json-schema.org/draft/2020-12/schema"
                        },
                        "schema": {
                          "$ref": "#/paths/~1v1~1x402~1json-sample-shape-infer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        },
                        "observations": {
                          "minItems": 1,
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "schemaPointer": {
                                "type": "string",
                                "maxLength": 4096
                              },
                              "occurrences": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 5000
                              },
                              "typeCounts": {
                                "maxItems": 6,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "enum": [
                                        "null",
                                        "boolean",
                                        "number",
                                        "string",
                                        "array",
                                        "object"
                                      ]
                                    },
                                    "count": {
                                      "type": "integer",
                                      "minimum": 1,
                                      "maximum": 5000
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "count"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "objectOccurrences": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 5000
                              },
                              "properties": {
                                "maxItems": 32,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "maxLength": 96
                                    },
                                    "presentCount": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 5000
                                    },
                                    "objectCount": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 5000
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "presentCount",
                                    "objectCount"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "elementOccurrences": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 5000
                              }
                            },
                            "required": [
                              "schemaPointer",
                              "occurrences",
                              "typeCounts"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "evidence",
                        "contractEstablished",
                        "sampleCount",
                        "dialect",
                        "schema",
                        "observations"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "boolean",
                              "const": true
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "null",
                                    "boolean",
                                    "number",
                                    "string"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "array"
                                },
                                "items": {
                                  "$ref": "#/paths/~1v1~1x402~1json-sample-shape-infer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                }
                              },
                              "required": [
                                "type",
                                "items"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "object"
                                },
                                "properties": {
                                  "type": "object",
                                  "propertyNames": {
                                    "type": "string"
                                  },
                                  "additionalProperties": {
                                    "$ref": "#/paths/~1v1~1x402~1json-sample-shape-infer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "additionalProperties": {
                                  "type": "boolean",
                                  "const": true
                                }
                              },
                              "required": [
                                "type",
                                "properties",
                                "additionalProperties"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "anyOf": {
                                  "minItems": 2,
                                  "maxItems": 6,
                                  "type": "array",
                                  "items": {
                                    "$ref": "#/paths/~1v1~1x402~1json-sample-shape-infer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                }
                              },
                              "required": [
                                "anyOf"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-sample-shape-infer",
                  "version": "0.29.0",
                  "result": {
                    "profile": "observed-json-shapes-v1",
                    "evidence": "observed-structure-only",
                    "contractEstablished": false,
                    "sampleCount": 2,
                    "dialect": "https://json-schema.org/draft/2020-12/schema",
                    "schema": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "tag": {
                          "anyOf": [
                            {
                              "type": "null"
                            },
                            {
                              "type": "string"
                            }
                          ]
                        },
                        "tags": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "additionalProperties": true
                    },
                    "observations": [
                      {
                        "schemaPointer": "",
                        "occurrences": 2,
                        "typeCounts": [
                          {
                            "type": "object",
                            "count": 2
                          }
                        ],
                        "objectOccurrences": 2,
                        "properties": [
                          {
                            "name": "id",
                            "presentCount": 2,
                            "objectCount": 2
                          },
                          {
                            "name": "tag",
                            "presentCount": 2,
                            "objectCount": 2
                          },
                          {
                            "name": "tags",
                            "presentCount": 2,
                            "objectCount": 2
                          }
                        ]
                      },
                      {
                        "schemaPointer": "/properties/id",
                        "occurrences": 2,
                        "typeCounts": [
                          {
                            "type": "number",
                            "count": 2
                          }
                        ]
                      },
                      {
                        "schemaPointer": "/properties/tag",
                        "occurrences": 2,
                        "typeCounts": [
                          {
                            "type": "null",
                            "count": 1
                          },
                          {
                            "type": "string",
                            "count": 1
                          }
                        ]
                      },
                      {
                        "schemaPointer": "/properties/tags",
                        "occurrences": 2,
                        "typeCounts": [
                          {
                            "type": "array",
                            "count": 2
                          }
                        ],
                        "elementOccurrences": 1
                      },
                      {
                        "schemaPointer": "/properties/tags/items",
                        "occurrences": 1,
                        "typeCounts": [
                          {
                            "type": "string",
                            "count": 1
                          }
                        ]
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "cd6d60c9fe4a6bf4587ba834b28f344a6e856e95e517470ced05bb3f24dedeed",
                    "outputSha256": "f482c987df131aeecd8ca5571ce7edc472358b72167e0f4ca417278c34d7b52a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.004",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/structured-log-template-pack": {
      "post": {
        "operationId": "x402_structured_log_template_pack",
        "summary": "Explicit scalar log templates",
        "description": "Factor supplied JSON log records into exact literal templates and typed caller-selected scalar occurrences, preserving parsed values and record order for client reconstruction.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/structured-log-template-pack.md"
        },
        "x-agent-discovery": {
          "intents": [
            "pack structured logs into reversible templates",
            "factor exact JSON log shapes",
            "extract caller-selected scalar log parameters"
          ],
          "whenToUse": [
            "Preserve every parsed JSON log value in exact literal templates and ordered occurrences",
            "Select scalar parameter pointers explicitly and reconstruct original records on the client"
          ],
          "whenNotToUse": [
            "Semantic log grouping, anomaly detection, root cause, severity or incident diagnosis",
            "Automatic timestamp, identifier, UUID, IP or secret detection and redaction",
            "Guaranteed compression, lower model token cost, authenticated history or safer sharing",
            "Preserving source member order, duplicate keys, numeric token spelling or pre-parse precision",
            "Network access, filesystem changes, target execution, publishing or deployment"
          ],
          "capabilities": [
            "Template equality includes every unselected literal, array order, present parameter pointers and scalar types",
            "Caller pointer order defines slots; first occurrence defines template indexes; record order is preserved",
            "Exact canonical structural keys distinguish null, absence, booleans, numbers and strings",
            "No automatic secret redaction: all original values remain in the artifact",
            "Pure supplied-input computation; complete bounded result admission before challenge; no external requests"
          ],
          "related": [
            "records-aggregate",
            "json-selector-redact"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "records": 256,
            "parameterPointers": 16,
            "sourceNodes": 6000,
            "semanticDepth": 8,
            "templates": 128,
            "extractedScalars": 4096,
            "aggregateCanonicalSkeletonBytes": 64000,
            "pointerBytes": 256,
            "pointerDepth": 8,
            "pointerTraversalSteps": 32768
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_POINTER",
            "OVERLAPPING_POINTERS",
            "UNSUPPORTED_TARGET",
            "LOG_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "minItems": 1,
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1x402~1structured-log-template-pack/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "parameterPointers": {
                    "minItems": 1,
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 256
                    }
                  }
                },
                "required": [
                  "records",
                  "parameterPointers"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1structured-log-template-pack/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1structured-log-template-pack/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "event": "download",
                    "job": "a",
                    "status": 200
                  },
                  {
                    "event": "download",
                    "job": "b",
                    "status": 200
                  },
                  {
                    "event": "download",
                    "job": "c",
                    "status": 500
                  }
                ],
                "parameterPointers": [
                  "/job"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "structured-log-template-pack",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "explicit-scalar-log-templates-v1"
                        },
                        "evidence": {
                          "type": "string",
                          "const": "literal-structure-only"
                        },
                        "reversibleParsedValues": {
                          "type": "boolean",
                          "const": true
                        },
                        "recordCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 256
                        },
                        "templateCounts": {
                          "minItems": 1,
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 256
                          }
                        },
                        "artifact": {
                          "type": "object",
                          "properties": {
                            "templates": {
                              "minItems": 1,
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "skeleton": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/paths/~1v1~1x402~1structured-log-template-pack/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                    }
                                  },
                                  "parameters": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "pointer": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        "type": {
                                          "type": "string",
                                          "enum": [
                                            "null",
                                            "boolean",
                                            "number",
                                            "string"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "pointer",
                                        "type"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "skeleton",
                                  "parameters"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "occurrences": {
                              "minItems": 1,
                              "maxItems": 256,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "template": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 127
                                  },
                                  "values": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": [
                                        "null",
                                        "boolean",
                                        "number",
                                        "string"
                                      ]
                                    }
                                  }
                                },
                                "required": [
                                  "template",
                                  "values"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "templates",
                            "occurrences"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "profile",
                        "evidence",
                        "reversibleParsedValues",
                        "recordCount",
                        "templateCounts",
                        "artifact"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1structured-log-template-pack/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1structured-log-template-pack/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "structured-log-template-pack",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-scalar-log-templates-v1",
                    "evidence": "literal-structure-only",
                    "reversibleParsedValues": true,
                    "recordCount": 3,
                    "templateCounts": [
                      2,
                      1
                    ],
                    "artifact": {
                      "templates": [
                        {
                          "skeleton": {
                            "event": "download",
                            "job": null,
                            "status": 200
                          },
                          "parameters": [
                            {
                              "pointer": "/job",
                              "type": "string"
                            }
                          ]
                        },
                        {
                          "skeleton": {
                            "event": "download",
                            "job": null,
                            "status": 500
                          },
                          "parameters": [
                            {
                              "pointer": "/job",
                              "type": "string"
                            }
                          ]
                        }
                      ],
                      "occurrences": [
                        {
                          "template": 0,
                          "values": [
                            "a"
                          ]
                        },
                        {
                          "template": 0,
                          "values": [
                            "b"
                          ]
                        },
                        {
                          "template": 1,
                          "values": [
                            "c"
                          ]
                        }
                      ]
                    }
                  },
                  "provenance": {
                    "inputSha256": "0087aee5b205d2f5247ee37e75b4d5f8cf0510e389a7984416d065178c67b7e3",
                    "outputSha256": "9893c0221a4326c737233d80d598f160bb0cd6fdd3b2c26de15d216866f890cf",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/text-boundary-segment": {
      "post": {
        "operationId": "x402_text_boundary_segment",
        "summary": "Literal-boundary UTF-8 windows",
        "description": "Create source-preserving UTF-8-byte-bounded text windows with literal double-LF, LF and ASCII-space cut priority, scalar-safe overlap, exact UTF-16/UTF-8 spans and an aggregate duplication budget.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-boundary-segment.md"
        },
        "x-agent-discovery": {
          "intents": [
            "split text into byte bounded windows",
            "segment document at literal line boundaries",
            "create chunks with exact source spans and overlap budget"
          ],
          "whenToUse": [
            "Creating scalar-safe UTF-8 payload windows from supplied Unicode text",
            "Favoring literal double-LF, LF and ASCII-space boundaries with exact core reconstruction",
            "Bounding aggregate source-byte duplication independently of per-chunk overlap"
          ],
          "whenNotToUse": [
            "Model tokenizer limits, token costs, embedding or semantic retrieval",
            "Sentence, grapheme, word, CommonMark or Unicode line segmentation",
            "Source authenticity, linguistic understanding, normalization or privacy redaction",
            "Fetching sources, writing files, model calls, target execution or changing external state"
          ],
          "capabilities": [
            "Half-open absolute UTF-16 and UTF-8 source/core spans",
            "Nonoverlapping advancing cores with longest scalar-safe preceding-source suffix",
            "Literal boundary priority in the final half of each reserved core byte window",
            "Atomic chunk, returned-text, serialized-output and duplication admission",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "text-chunk",
            "document-chunk-audit",
            "context-budget-pack"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "literal-boundary-utf8-windows-v1",
            "textUtf8Bytes": 60000,
            "textUtf16Units": 60000,
            "maxChunkBytes": 8192,
            "minChunkBytes": 8,
            "overlapBytes": 2048,
            "minimumCoreCapacity": 4,
            "maxDuplicatedBytes": 60000,
            "chunks": 512,
            "returnedTextUtf8Bytes": 120000,
            "boundarySearchProbes": 20000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "TEXT_CAPACITY",
            "TEXT_BYTES_LIMIT",
            "TEXT_CHUNK_LIMIT",
            "TEXT_DUPLICATION_LIMIT",
            "TEXT_RETURNED_BYTES_LIMIT",
            "TEXT_WORK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 60000
                  },
                  "maxChunkBytes": {
                    "type": "integer",
                    "minimum": 8,
                    "maximum": 8192
                  },
                  "overlapBytes": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 2048
                  },
                  "maxDuplicatedBytes": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 60000
                  }
                },
                "required": [
                  "text",
                  "maxChunkBytes",
                  "overlapBytes",
                  "maxDuplicatedBytes"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "A😀 B C",
                "maxChunkBytes": 8,
                "overlapBytes": 2,
                "maxDuplicatedBytes": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-boundary-segment",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "literal-boundary-utf8-windows-v1"
                        },
                        "sourceBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 60000
                        },
                        "returnedTextBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 120000
                        },
                        "duplicatedBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 60000
                        },
                        "chunks": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "startByte": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "endByte": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "coreStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "coreEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "coreStartByte": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "coreEndByte": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "text": {
                                "type": "string",
                                "maxLength": 8192
                              },
                              "utf8Bytes": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 8192
                              },
                              "overlapBytes": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 2048
                              },
                              "boundary": {
                                "type": "string",
                                "enum": [
                                  "double-lf",
                                  "lf",
                                  "ascii-space",
                                  "scalar-limit",
                                  "end"
                                ]
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "startByte",
                              "endByte",
                              "coreStart",
                              "coreEnd",
                              "coreStartByte",
                              "coreEndByte",
                              "text",
                              "utf8Bytes",
                              "overlapBytes",
                              "boundary"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "sourceBytes",
                        "returnedTextBytes",
                        "duplicatedBytes",
                        "chunks"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-boundary-segment",
                  "version": "0.29.0",
                  "result": {
                    "profile": "literal-boundary-utf8-windows-v1",
                    "sourceBytes": 9,
                    "returnedTextBytes": 10,
                    "duplicatedBytes": 1,
                    "chunks": [
                      {
                        "start": 0,
                        "end": 4,
                        "startByte": 0,
                        "endByte": 6,
                        "coreStart": 0,
                        "coreEnd": 4,
                        "coreStartByte": 0,
                        "coreEndByte": 6,
                        "text": "A😀 ",
                        "utf8Bytes": 6,
                        "overlapBytes": 0,
                        "boundary": "ascii-space"
                      },
                      {
                        "start": 3,
                        "end": 7,
                        "startByte": 5,
                        "endByte": 9,
                        "coreStart": 4,
                        "coreEnd": 7,
                        "coreStartByte": 6,
                        "coreEndByte": 9,
                        "text": " B C",
                        "utf8Bytes": 4,
                        "overlapBytes": 1,
                        "boundary": "end"
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "96f0ba6f9e9528c0885e699141905fb70393489c27189f4aecbc5c5ec38c1602",
                    "outputSha256": "6f7758dd5b440e564c1865a1407a6a63ed19a29762fb88f4f85adb4c4f1d82f1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.004",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/rectangle-set-compose": {
      "post": {
        "operationId": "x402_rectangle_set_compose",
        "summary": "Exact integer rectangle set algebra",
        "description": "Compose union, intersection, A-minus-B difference or XOR of declared axis-aligned half-open integer rectangles into deterministic x-first disjoint rectangles, exact integer area and bounds.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/rectangle-set-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "union intersect subtract xor rectangular regions",
            "subtract declared exclusions from page tile regions",
            "create canonical disjoint rectangles and exact area"
          ],
          "whenToUse": [
            "Exact set algebra over caller-supplied Cartesian integer regions",
            "Generating disjoint drawing or selection data from axis-aligned half-open rectangles",
            "Computing exact coordinate-squared area beyond JavaScript safe integers"
          ],
          "whenNotToUse": [
            "Rotated shapes, arbitrary polygons, geographic or geodesic area, CRS or units conversion",
            "Image modification, masking, redaction or identifying actual objects",
            "Click safety, collision physics, optimal packing or minimum-rectangle decomposition",
            "Fetching sources, writing files, model calls, target execution or changing external state"
          ],
          "capabilities": [
            "Exact canonical decimal-string coordinates and BigInt arithmetic",
            "Operand unions ignore input ordering and duplicate coverage",
            "X-first interval sweep merges touching selected y intervals and identical intervals across consecutive x slabs",
            "Canonical disjoint output sorted numerically with half-open bounds and exact area",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "interval-analyze"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "integer-half-open-rectangle-sets-v1",
            "inputRectangles": 32,
            "absoluteCoordinate": "1000000000000",
            "xEndpoints": 64,
            "yEndpoints": 64,
            "elementaryCells": 3969,
            "resultRectangles": 1024,
            "outputCoordinateStrings": 4096,
            "sweepWork": 100000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "RECTANGLE_COUNT_LIMIT",
            "RECTANGLE_COORDINATE_RANGE",
            "RECTANGLE_EXTENT",
            "RECTANGLE_WORK_LIMIT",
            "RECTANGLE_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "operation": {
                    "type": "string",
                    "enum": [
                      "union",
                      "intersection",
                      "difference",
                      "xor"
                    ]
                  },
                  "a": {
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        }
                      ],
                      "items": false,
                      "minItems": 4,
                      "maxItems": 4
                    }
                  },
                  "b": {
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        }
                      ],
                      "items": false,
                      "minItems": 4,
                      "maxItems": 4
                    }
                  }
                },
                "required": [
                  "operation",
                  "a",
                  "b"
                ],
                "additionalProperties": false
              },
              "example": {
                "operation": "difference",
                "a": [
                  [
                    "0",
                    "0",
                    "6",
                    "4"
                  ]
                ],
                "b": [
                  [
                    "2",
                    "1",
                    "4",
                    "3"
                  ]
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "rectangle-set-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "integer-half-open-rectangle-sets-v1"
                        },
                        "operation": {
                          "type": "string",
                          "enum": [
                            "union",
                            "intersection",
                            "difference",
                            "xor"
                          ]
                        },
                        "coordinateModel": {
                          "type": "string",
                          "const": "caller-integer-grid"
                        },
                        "boundary": {
                          "type": "string",
                          "const": "half-open"
                        },
                        "rectangles": {
                          "maxItems": 1024,
                          "type": "array",
                          "items": {
                            "type": "array",
                            "prefixItems": [
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9][0-9]*)$"
                              },
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9][0-9]*)$"
                              },
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9][0-9]*)$"
                              },
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9][0-9]*)$"
                              }
                            ],
                            "items": false,
                            "minItems": 4,
                            "maxItems": 4
                          }
                        },
                        "area": {
                          "type": "string",
                          "maxLength": 25,
                          "pattern": "^(?:0|[1-9][0-9]*)$"
                        },
                        "bounds": {
                          "anyOf": [
                            {
                              "type": "array",
                              "prefixItems": [
                                {
                                  "type": "string",
                                  "maxLength": 14,
                                  "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                },
                                {
                                  "type": "string",
                                  "maxLength": 14,
                                  "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                },
                                {
                                  "type": "string",
                                  "maxLength": 14,
                                  "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                },
                                {
                                  "type": "string",
                                  "maxLength": 14,
                                  "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                }
                              ],
                              "items": false,
                              "minItems": 4,
                              "maxItems": 4
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "profile",
                        "operation",
                        "coordinateModel",
                        "boundary",
                        "rectangles",
                        "area",
                        "bounds"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "rectangle-set-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "integer-half-open-rectangle-sets-v1",
                    "operation": "difference",
                    "coordinateModel": "caller-integer-grid",
                    "boundary": "half-open",
                    "rectangles": [
                      [
                        "0",
                        "0",
                        "2",
                        "4"
                      ],
                      [
                        "2",
                        "0",
                        "4",
                        "1"
                      ],
                      [
                        "2",
                        "3",
                        "4",
                        "4"
                      ],
                      [
                        "4",
                        "0",
                        "6",
                        "4"
                      ]
                    ],
                    "area": "20",
                    "bounds": [
                      "0",
                      "0",
                      "6",
                      "4"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "78c60701985f51c5f58fd98603b34f2205596ce461af7da13a1083c7454b8021",
                    "outputSha256": "069c4ac83e8387a1f235ddd7b78bccbdfbf2592a44e19809a782352db0e4712c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/records-crosstab-compose": {
      "post": {
        "operationId": "x402_records_crosstab_compose",
        "summary": "Exact typed record crosstab",
        "description": "Compose first-occurrence typed row/column axes, dense counts, exact decimal-string sums and per-measure missing/null/valid coverage with aligned margins.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-crosstab-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "build typed exact decimal crosstab matrix",
            "pivot records with missing null measure coverage",
            "compose chart ready counts and decimal totals"
          ],
          "whenToUse": [
            "Producing typed crossed categories with exact decimal sums from supplied records",
            "Preserving missing versus null and scalar-type distinctions",
            "Preparing aligned count grids and row/column/grand totals"
          ],
          "whenNotToUse": [
            "Accounting advice, statistical inference or verification of supplied observations",
            "Floating-point measurements, automatic numeric string coercion or implicit chart conversion",
            "Locale ordering, category normalization or inventing absent categories",
            "Fetching sources, changing external state or executing supplied data"
          ],
          "capabilities": [
            "RFC 6901 selection with first-occurrence typed tuples",
            "Exact BigInt scale-18 decimal aggregation with canonical string outputs",
            "Complete per-measure valid, null and missing coverage",
            "Dense-axis and metric-slot admission before matrix allocation",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "records-aggregate",
            "record-profile",
            "decimal-distribution-summarize"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "typed-exact-decimal-crosstab-v1",
            "records": 1000,
            "rowPointers": 2,
            "columnPointers": 2,
            "measures": 4,
            "axisTuples": 128,
            "denseCells": 1024,
            "metricSlotsIncludingMargins": 4096,
            "pointerSteps": 64000,
            "decimalParses": 4000,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "pointerCharacters": 2048,
            "measureNameCharacters": 128
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "CROSSTAB_MEASURE_NAME",
            "CROSSTAB_DECIMAL",
            "CROSSTAB_AXIS",
            "CROSSTAB_AXIS_LIMIT",
            "CROSSTAB_CELL_LIMIT",
            "CROSSTAB_WORK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {}
                    }
                  },
                  "rowPointers": {
                    "minItems": 1,
                    "maxItems": 2,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 2048,
                      "pattern": "^(?:\\/(?:[^~]|~[01])*)*$"
                    }
                  },
                  "columnPointers": {
                    "minItems": 1,
                    "maxItems": 2,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 2048,
                      "pattern": "^(?:\\/(?:[^~]|~[01])*)*$"
                    }
                  },
                  "measures": {
                    "maxItems": 4,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "pointer": {
                          "type": "string",
                          "maxLength": 2048,
                          "pattern": "^(?:\\/(?:[^~]|~[01])*)*$"
                        }
                      },
                      "required": [
                        "name",
                        "pointer"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "records",
                  "rowPointers",
                  "columnPointers",
                  "measures"
                ],
                "additionalProperties": false
              },
              "example": {
                "records": [
                  {
                    "team": "A",
                    "status": "open",
                    "amount": "0.1"
                  },
                  {
                    "team": "A",
                    "status": "open",
                    "amount": "0.2"
                  },
                  {
                    "team": "A",
                    "status": "closed",
                    "amount": null
                  },
                  {
                    "team": "B",
                    "status": "open"
                  },
                  {
                    "team": "B",
                    "status": "closed",
                    "amount": "-0.3"
                  }
                ],
                "rowPointers": [
                  "/team"
                ],
                "columnPointers": [
                  "/status"
                ],
                "measures": [
                  {
                    "name": "amount",
                    "pointer": "/amount"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-crosstab-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "typed-exact-decimal-crosstab-v1"
                        },
                        "axisOrder": {
                          "type": "string",
                          "const": "first-occurrence"
                        },
                        "rowAxes": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "minItems": 1,
                            "maxItems": 2,
                            "type": "array",
                            "items": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "missing"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "null"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "string"
                                    },
                                    "value": {
                                      "type": "string",
                                      "maxLength": 100000
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "number"
                                    },
                                    "value": {
                                      "type": "number"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "boolean"
                                    },
                                    "value": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            }
                          }
                        },
                        "columnAxes": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "minItems": 1,
                            "maxItems": 2,
                            "type": "array",
                            "items": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "missing"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "null"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "string"
                                    },
                                    "value": {
                                      "type": "string",
                                      "maxLength": 100000
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "number"
                                    },
                                    "value": {
                                      "type": "number"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "boolean"
                                    },
                                    "value": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            }
                          }
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "cells": {
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "maxItems": 128,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 1000
                                }
                              }
                            },
                            "rowTotals": {
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000
                              }
                            },
                            "columnTotals": {
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000
                              }
                            },
                            "grandTotal": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1000
                            }
                          },
                          "required": [
                            "cells",
                            "rowTotals",
                            "columnTotals",
                            "grandTotal"
                          ],
                          "additionalProperties": false
                        },
                        "measures": {
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              "pointer": {
                                "type": "string",
                                "maxLength": 2048,
                                "pattern": "^(?:\\/(?:[^~]|~[01])*)*$"
                              },
                              "sums": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "maxItems": 128,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "maxLength": 47,
                                        "pattern": "^(?:0|-?[1-9]\\d{0,26}|-?(?:0|[1-9]\\d{0,26})\\.\\d{0,17}[1-9])$"
                                      }
                                    }
                                  },
                                  "rowTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "maxLength": 47,
                                      "pattern": "^(?:0|-?[1-9]\\d{0,26}|-?(?:0|[1-9]\\d{0,26})\\.\\d{0,17}[1-9])$"
                                    }
                                  },
                                  "columnTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "maxLength": 47,
                                      "pattern": "^(?:0|-?[1-9]\\d{0,26}|-?(?:0|[1-9]\\d{0,26})\\.\\d{0,17}[1-9])$"
                                    }
                                  },
                                  "grandTotal": {
                                    "type": "string",
                                    "maxLength": 47,
                                    "pattern": "^(?:0|-?[1-9]\\d{0,26}|-?(?:0|[1-9]\\d{0,26})\\.\\d{0,17}[1-9])$"
                                  }
                                },
                                "required": [
                                  "cells",
                                  "rowTotals",
                                  "columnTotals",
                                  "grandTotal"
                                ],
                                "additionalProperties": false
                              },
                              "validCounts": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "maxItems": 128,
                                      "type": "array",
                                      "items": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 1000
                                      }
                                    }
                                  },
                                  "rowTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "columnTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "grandTotal": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000
                                  }
                                },
                                "required": [
                                  "cells",
                                  "rowTotals",
                                  "columnTotals",
                                  "grandTotal"
                                ],
                                "additionalProperties": false
                              },
                              "nullCounts": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "maxItems": 128,
                                      "type": "array",
                                      "items": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 1000
                                      }
                                    }
                                  },
                                  "rowTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "columnTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "grandTotal": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000
                                  }
                                },
                                "required": [
                                  "cells",
                                  "rowTotals",
                                  "columnTotals",
                                  "grandTotal"
                                ],
                                "additionalProperties": false
                              },
                              "missingCounts": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "maxItems": 128,
                                      "type": "array",
                                      "items": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 1000
                                      }
                                    }
                                  },
                                  "rowTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "columnTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "grandTotal": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000
                                  }
                                },
                                "required": [
                                  "cells",
                                  "rowTotals",
                                  "columnTotals",
                                  "grandTotal"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "name",
                              "pointer",
                              "sums",
                              "validCounts",
                              "nullCounts",
                              "missingCounts"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "axisOrder",
                        "rowAxes",
                        "columnAxes",
                        "counts",
                        "measures"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-crosstab-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "typed-exact-decimal-crosstab-v1",
                    "axisOrder": "first-occurrence",
                    "rowAxes": [
                      [
                        {
                          "type": "string",
                          "value": "A"
                        }
                      ],
                      [
                        {
                          "type": "string",
                          "value": "B"
                        }
                      ]
                    ],
                    "columnAxes": [
                      [
                        {
                          "type": "string",
                          "value": "open"
                        }
                      ],
                      [
                        {
                          "type": "string",
                          "value": "closed"
                        }
                      ]
                    ],
                    "counts": {
                      "cells": [
                        [
                          2,
                          1
                        ],
                        [
                          1,
                          1
                        ]
                      ],
                      "rowTotals": [
                        3,
                        2
                      ],
                      "columnTotals": [
                        3,
                        2
                      ],
                      "grandTotal": 5
                    },
                    "measures": [
                      {
                        "name": "amount",
                        "pointer": "/amount",
                        "sums": {
                          "cells": [
                            [
                              "0.3",
                              "0"
                            ],
                            [
                              "0",
                              "-0.3"
                            ]
                          ],
                          "rowTotals": [
                            "0.3",
                            "-0.3"
                          ],
                          "columnTotals": [
                            "0.3",
                            "-0.3"
                          ],
                          "grandTotal": "0"
                        },
                        "validCounts": {
                          "cells": [
                            [
                              2,
                              0
                            ],
                            [
                              0,
                              1
                            ]
                          ],
                          "rowTotals": [
                            2,
                            1
                          ],
                          "columnTotals": [
                            2,
                            1
                          ],
                          "grandTotal": 3
                        },
                        "nullCounts": {
                          "cells": [
                            [
                              0,
                              1
                            ],
                            [
                              0,
                              0
                            ]
                          ],
                          "rowTotals": [
                            1,
                            0
                          ],
                          "columnTotals": [
                            0,
                            1
                          ],
                          "grandTotal": 1
                        },
                        "missingCounts": {
                          "cells": [
                            [
                              0,
                              0
                            ],
                            [
                              1,
                              0
                            ]
                          ],
                          "rowTotals": [
                            0,
                            1
                          ],
                          "columnTotals": [
                            1,
                            0
                          ],
                          "grandTotal": 1
                        }
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "72b700a118cc9572364a507b93986dd707aadd075e3d697f3242807d7313db75",
                    "outputSha256": "450697aed2f4eb568f1bb009e8db63f0e30a8691f3538227936e23d6345d8b68",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/polyline-rectangle-clip": {
      "post": {
        "operationId": "x402_polyline_rectangle_clip",
        "summary": "Exact closed rectangle polyline clipping",
        "description": "Clip each directed source segment against a closed integer rectangle and return exact reduced rational parameters and endpoints, preserving point contacts and per-segment provenance.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/polyline-rectangle-clip.md"
        },
        "x-agent-discovery": {
          "intents": [
            "clip polyline to closed rectangle viewport",
            "intersect line segments with exact rational coordinates",
            "retain segment provenance and tangent point intersections"
          ],
          "whenToUse": [
            "Exact viewport clipping on a caller-supplied integer Cartesian grid",
            "Obtaining ordered segment fragments with exact source parameters",
            "Keeping boundary and tangent contacts without rounded coordinates"
          ],
          "whenNotToUse": [
            "Half-open rectangle set operations or polygon clipping",
            "Geodesic distances, CRS conversion, antimeridian handling or physical units",
            "Merging fragments, topology guarantees or direct floating-point renderer output",
            "Fetching sources, changing external state or executing supplied data"
          ],
          "capabilities": [
            "Closed boundaries and exact reduced rational interpolation",
            "Source-order pieces without merging adjacent segments",
            "Inside repeated vertices retain t0=0 and t1=1",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "rectangle-set-compose",
            "polyline-simplify"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "integer-polyline-closed-rectangle-clip-v1",
            "points": 512,
            "pieces": 511,
            "clippingInequalities": 2044,
            "absoluteCoordinate": "1000000000000"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "POLYLINE_COORDINATE_RANGE",
            "POLYLINE_RECTANGLE_EXTENT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "points": {
                    "minItems": 2,
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                        }
                      ],
                      "items": false,
                      "minItems": 2,
                      "maxItems": 2
                    }
                  },
                  "rectangle": {
                    "type": "array",
                    "prefixItems": [
                      {
                        "type": "string",
                        "maxLength": 14,
                        "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                      },
                      {
                        "type": "string",
                        "maxLength": 14,
                        "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                      },
                      {
                        "type": "string",
                        "maxLength": 14,
                        "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                      },
                      {
                        "type": "string",
                        "maxLength": 14,
                        "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                      }
                    ],
                    "items": false,
                    "minItems": 4,
                    "maxItems": 4
                  }
                },
                "required": [
                  "points",
                  "rectangle"
                ],
                "additionalProperties": false
              },
              "example": {
                "points": [
                  [
                    "-2",
                    "0"
                  ],
                  [
                    "5",
                    "3"
                  ]
                ],
                "rectangle": [
                  "0",
                  "0",
                  "4",
                  "2"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "polyline-rectangle-clip",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "integer-polyline-closed-rectangle-clip-v1"
                        },
                        "coordinateModel": {
                          "type": "string",
                          "const": "caller-integer-grid"
                        },
                        "boundary": {
                          "type": "string",
                          "const": "closed"
                        },
                        "pieces": {
                          "maxItems": 511,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "segmentIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 510
                              },
                              "t0": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 102,
                                    "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 101,
                                    "pattern": "^[1-9]\\d{0,100}$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "t1": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 102,
                                    "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 101,
                                    "pattern": "^[1-9]\\d{0,100}$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "start": {
                                "type": "array",
                                "prefixItems": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 102,
                                        "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 101,
                                        "pattern": "^[1-9]\\d{0,100}$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 102,
                                        "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 101,
                                        "pattern": "^[1-9]\\d{0,100}$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  }
                                ],
                                "items": false,
                                "minItems": 2,
                                "maxItems": 2
                              },
                              "end": {
                                "type": "array",
                                "prefixItems": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 102,
                                        "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 101,
                                        "pattern": "^[1-9]\\d{0,100}$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 102,
                                        "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 101,
                                        "pattern": "^[1-9]\\d{0,100}$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  }
                                ],
                                "items": false,
                                "minItems": 2,
                                "maxItems": 2
                              }
                            },
                            "required": [
                              "segmentIndex",
                              "t0",
                              "t1",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "coordinateModel",
                        "boundary",
                        "pieces"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "polyline-rectangle-clip",
                  "version": "0.29.0",
                  "result": {
                    "profile": "integer-polyline-closed-rectangle-clip-v1",
                    "coordinateModel": "caller-integer-grid",
                    "boundary": "closed",
                    "pieces": [
                      {
                        "segmentIndex": 0,
                        "t0": {
                          "numerator": "2",
                          "denominator": "7"
                        },
                        "t1": {
                          "numerator": "2",
                          "denominator": "3"
                        },
                        "start": [
                          {
                            "numerator": "0",
                            "denominator": "1"
                          },
                          {
                            "numerator": "6",
                            "denominator": "7"
                          }
                        ],
                        "end": [
                          {
                            "numerator": "8",
                            "denominator": "3"
                          },
                          {
                            "numerator": "2",
                            "denominator": "1"
                          }
                        ]
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "1cbe0f994106b3cdfc25cde150ec342300e1513d4566d88ab10f964ba263744f",
                    "outputSha256": "3e112721135d19b01616446d48a0d46335bd8b3d76efcf67cff02782c3431585",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/polyline-simplify": {
      "post": {
        "operationId": "x402_polyline_simplify",
        "summary": "Exact integer-grid polyline simplification",
        "description": "Simplify a supplied integer polyline with exact point-to-segment Ramer–Douglas–Peucker decisions, original retained indexes and per-final-segment squared vertex-deviation witnesses.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/polyline-simplify.md"
        },
        "x-agent-discovery": {
          "intents": [
            "simplify integer polyline with exact tolerance",
            "reduce original vertices with retained source indexes",
            "certify squared original vertex deviations for a preview trace"
          ],
          "whenToUse": [
            "Reducing original-vertex polylines for previews or vector exports",
            "Requiring exact inclusive tolerance decisions and earliest-index distance ties",
            "Checking original removed vertices against their final enclosing segments"
          ],
          "whenNotToUse": [
            "Minimum-vertex optimization, topology or area preservation",
            "Curve smoothing, map matching or global geometry equivalence",
            "General Hausdorff certificates, geodesic distances or coordinate conversion",
            "Fetching sources, changing external state or executing supplied data"
          ],
          "capabilities": [
            "Iterative exact point-to-segment RDP with endpoint projection clamping",
            "Strictly-greater splitting and earliest-source-index ties",
            "Preserved first/last source indexes including coincident coordinates",
            "Reduced rational maximum squared vertex deviation with earliest witness per segment",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "polyline-rectangle-clip",
            "rectangle-set-compose"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "exact-integer-rdp-polyline-v1",
            "points": 256,
            "absoluteCoordinate": "1000000000000",
            "tolerance": "2000000000000",
            "distanceTests": 35000,
            "worstRdpInteriorTests": 32385,
            "maximumCertificateTests": 254
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "POLYLINE_COORDINATE_RANGE",
            "POLYLINE_TOLERANCE_RANGE",
            "POLYLINE_WORK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "points": {
                    "minItems": 2,
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                        }
                      ],
                      "items": false,
                      "minItems": 2,
                      "maxItems": 2
                    }
                  },
                  "tolerance": {
                    "type": "string",
                    "maxLength": 13,
                    "pattern": "^(?:0|[1-9]\\d{0,12})$"
                  }
                },
                "required": [
                  "points",
                  "tolerance"
                ],
                "additionalProperties": false
              },
              "example": {
                "points": [
                  [
                    "0",
                    "0"
                  ],
                  [
                    "1",
                    "1"
                  ],
                  [
                    "2",
                    "0"
                  ],
                  [
                    "3",
                    "0"
                  ]
                ],
                "tolerance": "1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "polyline-simplify",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "exact-integer-rdp-polyline-v1"
                        },
                        "coordinateModel": {
                          "type": "string",
                          "const": "caller-integer-grid"
                        },
                        "indexes": {
                          "minItems": 2,
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 255
                          }
                        },
                        "points": {
                          "minItems": 2,
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "array",
                            "prefixItems": [
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                              },
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                              }
                            ],
                            "items": false,
                            "minItems": 2,
                            "maxItems": 2
                          }
                        },
                        "segments": {
                          "minItems": 1,
                          "maxItems": 255,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "startIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 255
                              },
                              "endIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 255
                              },
                              "maxSquaredDeviation": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 102,
                                    "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 101,
                                    "pattern": "^[1-9]\\d{0,100}$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "witnessIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 255
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "startIndex",
                              "endIndex",
                              "maxSquaredDeviation",
                              "witnessIndex"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "coordinateModel",
                        "indexes",
                        "points",
                        "segments"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "polyline-simplify",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-integer-rdp-polyline-v1",
                    "coordinateModel": "caller-integer-grid",
                    "indexes": [
                      0,
                      3
                    ],
                    "points": [
                      [
                        "0",
                        "0"
                      ],
                      [
                        "3",
                        "0"
                      ]
                    ],
                    "segments": [
                      {
                        "startIndex": 0,
                        "endIndex": 3,
                        "maxSquaredDeviation": {
                          "numerator": "1",
                          "denominator": "1"
                        },
                        "witnessIndex": 1
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "e80ee76754de76df6f80c9527775670d590b6da264147352c147e5db9a10f837",
                    "outputSha256": "4204e80b58e4bc7f9d81f32ece7c6a8e16aea1ee8babcce554c1b8d1481457f6",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/keyed-changefeed-materialize": {
      "post": {
        "operationId": "x402_keyed_changefeed_materialize",
        "summary": "Atomic keyed changefeed snapshot materializer",
        "description": "Fold supplied ordered revision-checked put/delete events into a fresh complete keyed snapshot with tombstones and receipts, or return the first tentative-fold conflict without partial state. Valid conflicts are normal paid results; never reads or writes a database.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/keyed-changefeed-materialize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "materialize revision checked keyed event batch",
            "build next offline snapshot with tombstones",
            "locate first atomic changefeed conflict"
          ],
          "whenToUse": [
            "Preparing a complete next snapshot from caller-supplied records and events",
            "Keeping exact typed tuple identity and explicit revision arithmetic",
            "Inspecting an offline ordered event fold before separately authorized persistence"
          ],
          "whenNotToUse": [
            "Live CDC ingestion, database CAS or transactions, cursor advancement or durable writes",
            "Historical event deduplication, exactly-once execution or authenticated event provenance",
            "Partial record patches, last-writer-wins, tombstone garbage collection or CRDT convergence",
            "Fetching sources, changing external state or executing supplied data"
          ],
          "capabilities": [
            "Atomic complete snapshot or first-conflict diagnostic with no partial receipts",
            "Tombstones and explicit recreation preserve snapshot insertion order",
            "Conflict precedence is revision mismatch, delete not live, then revision exhaustion",
            "Valid materialized and conflict outcomes each incur the proposed per-result price",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "json-patch",
            "idempotency-conflict-check",
            "replay-divergence-check",
            "message-batch-plan"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "explicit-key-revision-fold-v1",
            "snapshotEntries": 512,
            "events": 256,
            "finalKeys": 768,
            "keyComponentsPerTuple": 4,
            "keyComponentVisits": 3072,
            "identifierUtf8Bytes": 128,
            "aggregateKeyTupleUtf8Bytes": 64000,
            "revisionMaximum": "999999999999999999999999",
            "foldSteps": 256
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "MATERIALIZER_DUPLICATE_KEY",
            "MATERIALIZER_EVENT_ID",
            "MATERIALIZER_KEY_LIMIT",
            "STATE_WORK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "snapshot": {
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "key": {
                          "minItems": 1,
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              }
                            ]
                          }
                        },
                        "revision": {
                          "type": "string",
                          "maxLength": 24,
                          "pattern": "^[1-9]\\d{0,23}$"
                        },
                        "value": {
                          "anyOf": [
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {}
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "key",
                        "revision",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "events": {
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "key": {
                              "minItems": 1,
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 128
                                  },
                                  {
                                    "type": "boolean"
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  }
                                ]
                              }
                            },
                            "expectedRevision": {
                              "type": "string",
                              "maxLength": 24,
                              "pattern": "^(?:0|[1-9]\\d{0,23})$"
                            },
                            "op": {
                              "type": "string",
                              "const": "put"
                            },
                            "value": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {}
                            }
                          },
                          "required": [
                            "id",
                            "key",
                            "expectedRevision",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "key": {
                              "minItems": 1,
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 128
                                  },
                                  {
                                    "type": "boolean"
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  }
                                ]
                              }
                            },
                            "expectedRevision": {
                              "type": "string",
                              "maxLength": 24,
                              "pattern": "^(?:0|[1-9]\\d{0,23})$"
                            },
                            "op": {
                              "type": "string",
                              "const": "delete"
                            }
                          },
                          "required": [
                            "id",
                            "key",
                            "expectedRevision",
                            "op"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "snapshot",
                  "events"
                ],
                "additionalProperties": false
              },
              "example": {
                "snapshot": [
                  {
                    "key": [
                      "a"
                    ],
                    "revision": "1",
                    "value": {
                      "qty": 2
                    }
                  }
                ],
                "events": [
                  {
                    "id": "p1",
                    "key": [
                      "a"
                    ],
                    "expectedRevision": "1",
                    "op": "put",
                    "value": {
                      "qty": 3
                    }
                  },
                  {
                    "id": "d1",
                    "key": [
                      "a"
                    ],
                    "expectedRevision": "2",
                    "op": "delete"
                  },
                  {
                    "id": "p2",
                    "key": [
                      "b"
                    ],
                    "expectedRevision": "0",
                    "op": "put",
                    "value": {
                      "qty": 4
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "keyed-changefeed-materialize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "explicit-key-revision-fold-v1"
                            },
                            "status": {
                              "type": "string",
                              "const": "materialized"
                            },
                            "snapshot": {
                              "maxItems": 768,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "key": {
                                    "minItems": 1,
                                    "maxItems": 4,
                                    "type": "array",
                                    "items": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 128
                                        },
                                        {
                                          "type": "boolean"
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": -9007199254740991,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "revision": {
                                    "type": "string",
                                    "maxLength": 24,
                                    "pattern": "^[1-9]\\d{0,23}$"
                                  },
                                  "value": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string"
                                        },
                                        "additionalProperties": {}
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "key",
                                  "revision",
                                  "value"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "receipts": {
                              "maxItems": 256,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "eventIndex": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 255
                                  },
                                  "eventId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 128
                                  },
                                  "key": {
                                    "minItems": 1,
                                    "maxItems": 4,
                                    "type": "array",
                                    "items": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 128
                                        },
                                        {
                                          "type": "boolean"
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": -9007199254740991,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "previousRevision": {
                                    "type": "string",
                                    "maxLength": 24,
                                    "pattern": "^(?:0|[1-9]\\d{0,23})$"
                                  },
                                  "revision": {
                                    "type": "string",
                                    "maxLength": 24,
                                    "pattern": "^[1-9]\\d{0,23}$"
                                  },
                                  "op": {
                                    "type": "string",
                                    "enum": [
                                      "put",
                                      "delete"
                                    ]
                                  }
                                },
                                "required": [
                                  "eventIndex",
                                  "eventId",
                                  "key",
                                  "previousRevision",
                                  "revision",
                                  "op"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "conflict": {
                              "type": "null"
                            }
                          },
                          "required": [
                            "profile",
                            "status",
                            "snapshot",
                            "receipts",
                            "conflict"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "explicit-key-revision-fold-v1"
                            },
                            "status": {
                              "type": "string",
                              "const": "conflict"
                            },
                            "snapshot": {
                              "type": "null"
                            },
                            "receipts": {
                              "maxItems": 0,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "eventIndex": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 255
                                  },
                                  "eventId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 128
                                  },
                                  "key": {
                                    "minItems": 1,
                                    "maxItems": 4,
                                    "type": "array",
                                    "items": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 128
                                        },
                                        {
                                          "type": "boolean"
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": -9007199254740991,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "previousRevision": {
                                    "type": "string",
                                    "maxLength": 24,
                                    "pattern": "^(?:0|[1-9]\\d{0,23})$"
                                  },
                                  "revision": {
                                    "type": "string",
                                    "maxLength": 24,
                                    "pattern": "^[1-9]\\d{0,23}$"
                                  },
                                  "op": {
                                    "type": "string",
                                    "enum": [
                                      "put",
                                      "delete"
                                    ]
                                  }
                                },
                                "required": [
                                  "eventIndex",
                                  "eventId",
                                  "key",
                                  "previousRevision",
                                  "revision",
                                  "op"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "conflict": {
                              "type": "object",
                              "properties": {
                                "eventIndex": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 255
                                },
                                "eventId": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 128
                                },
                                "key": {
                                  "minItems": 1,
                                  "maxItems": 4,
                                  "type": "array",
                                  "items": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 128
                                      },
                                      {
                                        "type": "boolean"
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      }
                                    ]
                                  }
                                },
                                "code": {
                                  "type": "string",
                                  "enum": [
                                    "REVISION_MISMATCH",
                                    "DELETE_NOT_LIVE",
                                    "REVISION_EXHAUSTED"
                                  ]
                                },
                                "expectedRevision": {
                                  "type": "string",
                                  "maxLength": 24,
                                  "pattern": "^(?:0|[1-9]\\d{0,23})$"
                                },
                                "observedRevision": {
                                  "type": "string",
                                  "maxLength": 24,
                                  "pattern": "^(?:0|[1-9]\\d{0,23})$"
                                },
                                "observedState": {
                                  "type": "string",
                                  "enum": [
                                    "absent",
                                    "live",
                                    "tombstone"
                                  ]
                                },
                                "tentativePrefixLength": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 255
                                },
                                "observationScope": {
                                  "type": "string",
                                  "const": "tentative-input-fold"
                                }
                              },
                              "required": [
                                "eventIndex",
                                "eventId",
                                "key",
                                "code",
                                "expectedRevision",
                                "observedRevision",
                                "observedState",
                                "tentativePrefixLength",
                                "observationScope"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "status",
                            "snapshot",
                            "receipts",
                            "conflict"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "keyed-changefeed-materialize",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-key-revision-fold-v1",
                    "status": "materialized",
                    "snapshot": [
                      {
                        "key": [
                          "a"
                        ],
                        "revision": "3",
                        "value": null
                      },
                      {
                        "key": [
                          "b"
                        ],
                        "revision": "1",
                        "value": {
                          "qty": 4
                        }
                      }
                    ],
                    "receipts": [
                      {
                        "eventIndex": 0,
                        "eventId": "p1",
                        "key": [
                          "a"
                        ],
                        "previousRevision": "1",
                        "revision": "2",
                        "op": "put"
                      },
                      {
                        "eventIndex": 1,
                        "eventId": "d1",
                        "key": [
                          "a"
                        ],
                        "previousRevision": "2",
                        "revision": "3",
                        "op": "delete"
                      },
                      {
                        "eventIndex": 2,
                        "eventId": "p2",
                        "key": [
                          "b"
                        ],
                        "previousRevision": "0",
                        "revision": "1",
                        "op": "put"
                      }
                    ],
                    "conflict": null
                  },
                  "provenance": {
                    "inputSha256": "0806420b48aaad2e7df90f6c368d04a2f588e308b57e6536133b1b3593c84b21",
                    "outputSha256": "8e3b4cfcf12793cfa950f05dde67e059ad2da1b5ec7be8f17024463b28337204",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/dependency-version-select": {
      "post": {
        "operationId": "x402_dependency_version_select",
        "summary": "Exact finite dependency version selector",
        "description": "Select the lexicographically highest jointly compatible stable versions in caller-declared package priority from a complete supplied finite catalogue, with first-failure witnesses for every earlier combination. Valid infeasibility is a normal paid result; never contacts a registry or installs packages.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/dependency-version-select.md"
        },
        "x-agent-discovery": {
          "intents": [
            "select compatible finite dependency versions",
            "pin closed supplied release catalogue",
            "prove lexicographic finite version selection or catalogue infeasibility"
          ],
          "whenToUse": [
            "Choosing one supplied version of every package for a bounded offline release fixture",
            "Resolving conditional version requirements, including self-dependencies and cycles",
            "Regenerating and checking every rejected higher-priority combination from explicit evidence"
          ],
          "whenNotToUse": [
            "Registry lookup, download, installation, native npm lockfile generation or unseen releases",
            "Prerelease/build metadata or npm/pnpm/yarn range, peer, optional, workspace, platform or engine semantics",
            "Authenticity, vulnerability or license checks; minimum-change objectives; installation ordering",
            "Fetching sources, changing external state or executing supplied data"
          ],
          "capabilities": [
            "Typed stable version intervals with union arms and conjunctive active constraints",
            "Exact raw Cartesian domain bounded before enumeration, with last package varying fastest",
            "Input package priority and numeric descending candidates define deterministic selection",
            "Original candidate indexes and flattened source pointers make rejection witnesses reproducible",
            "Valid selected and infeasible outcomes each incur the proposed per-result price",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "semver-evaluate",
            "lockfile-inventory",
            "contract-version-route"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "closed-set-stable-semver-selection-v1",
            "packages": 16,
            "candidatesPerPackage": 8,
            "candidates": 64,
            "reachableCandidatesUnderJointCaps": 44,
            "constraints": 128,
            "intervalsPerConstraint": 4,
            "intervals": 512,
            "versionComponentMaximum": 1000000000,
            "identifierUtf8Bytes": 128,
            "completeCombinations": 4096,
            "constraintVisits": 524288,
            "membershipTests": 4096,
            "endpointTriples": 1024,
            "packagePositions": 65536
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "VERSION_CATALOGUE_DUPLICATE",
            "VERSION_CANDIDATE_LIMIT",
            "VERSION_CONSTRAINT_LIMIT",
            "VERSION_INTERVAL_LIMIT",
            "VERSION_INTERVAL",
            "VERSION_TARGET",
            "VERSION_SEARCH_LIMIT",
            "STATE_WORK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "packages": {
                    "minItems": 1,
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "versions": {
                          "minItems": 1,
                          "maxItems": 8,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "version": {
                                "type": "string",
                                "maxLength": 32,
                                "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                              },
                              "requires": {
                                "maxItems": 128,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "package": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 128
                                    },
                                    "anyOf": {
                                      "minItems": 1,
                                      "maxItems": 4,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "minInclusive": {
                                            "anyOf": [
                                              {
                                                "type": "string",
                                                "maxLength": 32,
                                                "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ]
                                          },
                                          "maxExclusive": {
                                            "anyOf": [
                                              {
                                                "type": "string",
                                                "maxLength": 32,
                                                "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ]
                                          }
                                        },
                                        "required": [
                                          "minInclusive",
                                          "maxExclusive"
                                        ],
                                        "additionalProperties": false
                                      }
                                    }
                                  },
                                  "required": [
                                    "package",
                                    "anyOf"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "version",
                              "requires"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "versions"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "requirements": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "package": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "anyOf": {
                          "minItems": 1,
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "minInclusive": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 32,
                                    "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "maxExclusive": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 32,
                                    "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "minInclusive",
                              "maxExclusive"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "package",
                        "anyOf"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "packages",
                  "requirements"
                ],
                "additionalProperties": false
              },
              "example": {
                "packages": [
                  {
                    "id": "renderer",
                    "versions": [
                      {
                        "version": "2.0.0",
                        "requires": [
                          {
                            "package": "core",
                            "anyOf": [
                              {
                                "minInclusive": "2.0.0",
                                "maxExclusive": "3.0.0"
                              }
                            ]
                          }
                        ]
                      },
                      {
                        "version": "1.5.0",
                        "requires": [
                          {
                            "package": "core",
                            "anyOf": [
                              {
                                "minInclusive": "1.0.0",
                                "maxExclusive": "2.0.0"
                              }
                            ]
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "id": "exporter",
                    "versions": [
                      {
                        "version": "1.0.0",
                        "requires": [
                          {
                            "package": "core",
                            "anyOf": [
                              {
                                "minInclusive": "1.0.0",
                                "maxExclusive": "2.0.0"
                              }
                            ]
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "id": "core",
                    "versions": [
                      {
                        "version": "2.1.0",
                        "requires": []
                      },
                      {
                        "version": "1.9.0",
                        "requires": []
                      }
                    ]
                  }
                ],
                "requirements": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "dependency-version-select",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "closed-set-stable-semver-selection-v1"
                            },
                            "selectionPolicy": {
                              "type": "string",
                              "const": "input-package-priority-highest-stable-version"
                            },
                            "candidateSourceOrders": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 7
                                }
                              }
                            },
                            "constraintSourcePointers": {
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "maxLength": 64,
                                "pattern": "^(?:\\/requirements\\/\\d+|\\/packages\\/\\d+\\/versions\\/\\d+\\/requires\\/\\d+)$"
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "selected"
                            },
                            "selected": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "packageIndex": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 15
                                  },
                                  "packageId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 128
                                  },
                                  "candidateIndex": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 7
                                  },
                                  "version": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                                  }
                                },
                                "required": [
                                  "packageIndex",
                                  "packageId",
                                  "candidateIndex",
                                  "version"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "proof": {
                              "type": "object",
                              "properties": {
                                "profile": {
                                  "type": "string",
                                  "const": "mixed-radix-first-failure-v1"
                                },
                                "searchSpaceSize": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 4096
                                },
                                "rejectionConstraintIndexes": {
                                  "maxItems": 4096,
                                  "type": "array",
                                  "items": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 127
                                  }
                                },
                                "selectedOrdinal": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 4095
                                }
                              },
                              "required": [
                                "profile",
                                "searchSpaceSize",
                                "rejectionConstraintIndexes",
                                "selectedOrdinal"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "selectionPolicy",
                            "candidateSourceOrders",
                            "constraintSourcePointers",
                            "status",
                            "selected",
                            "proof"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "closed-set-stable-semver-selection-v1"
                            },
                            "selectionPolicy": {
                              "type": "string",
                              "const": "input-package-priority-highest-stable-version"
                            },
                            "candidateSourceOrders": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 7
                                }
                              }
                            },
                            "constraintSourcePointers": {
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "maxLength": 64,
                                "pattern": "^(?:\\/requirements\\/\\d+|\\/packages\\/\\d+\\/versions\\/\\d+\\/requires\\/\\d+)$"
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "infeasible"
                            },
                            "selected": {
                              "type": "null"
                            },
                            "proof": {
                              "type": "object",
                              "properties": {
                                "profile": {
                                  "type": "string",
                                  "const": "mixed-radix-first-failure-v1"
                                },
                                "searchSpaceSize": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 4096
                                },
                                "rejectionConstraintIndexes": {
                                  "maxItems": 4096,
                                  "type": "array",
                                  "items": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 127
                                  }
                                },
                                "selectedOrdinal": {
                                  "type": "null"
                                }
                              },
                              "required": [
                                "profile",
                                "searchSpaceSize",
                                "rejectionConstraintIndexes",
                                "selectedOrdinal"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "selectionPolicy",
                            "candidateSourceOrders",
                            "constraintSourcePointers",
                            "status",
                            "selected",
                            "proof"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "dependency-version-select",
                  "version": "0.29.0",
                  "result": {
                    "profile": "closed-set-stable-semver-selection-v1",
                    "selectionPolicy": "input-package-priority-highest-stable-version",
                    "candidateSourceOrders": [
                      [
                        0,
                        1
                      ],
                      [
                        0
                      ],
                      [
                        0,
                        1
                      ]
                    ],
                    "constraintSourcePointers": [
                      "/packages/0/versions/0/requires/0",
                      "/packages/0/versions/1/requires/0",
                      "/packages/1/versions/0/requires/0"
                    ],
                    "status": "selected",
                    "selected": [
                      {
                        "packageIndex": 0,
                        "packageId": "renderer",
                        "candidateIndex": 1,
                        "version": "1.5.0"
                      },
                      {
                        "packageIndex": 1,
                        "packageId": "exporter",
                        "candidateIndex": 0,
                        "version": "1.0.0"
                      },
                      {
                        "packageIndex": 2,
                        "packageId": "core",
                        "candidateIndex": 1,
                        "version": "1.9.0"
                      }
                    ],
                    "proof": {
                      "profile": "mixed-radix-first-failure-v1",
                      "searchSpaceSize": 4,
                      "rejectionConstraintIndexes": [
                        2,
                        0,
                        1
                      ],
                      "selectedOrdinal": 3
                    }
                  },
                  "provenance": {
                    "inputSha256": "1a43376351d4e6394d1bd8a5ba6158ade9566c0f0245f59a982bc40329a54d24",
                    "outputSha256": "8d93e328f273dc0a99e6a07467368db39f5e7fafd216896d368194aea13ff6a6",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.008",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/records-link-candidates": {
      "post": {
        "operationId": "x402_records_link_candidates",
        "summary": "Exact Record Link Candidates",
        "description": "Produce every admissible cross-table candidate using explicitly normalized Unicode-scalar Levenshtein distances and exact integer weighted costs. Includes all tied best candidates; never selects an identity, asserts duplicates or merges records.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-link-candidates.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find reproducible near-spelling candidates between small supplied part catalogues",
            "Compare asset labels under explicit normalization and edit-distance cutoffs"
          ],
          "whenToUse": [
            "Return a complete bounded candidate queue with exact field-distance evidence"
          ],
          "whenNotToUse": [
            "Identity resolution, true-duplicate assertions, automatic merging, confidence probabilities or semantic similarity",
            "Medical, employment, credit or other high-impact decisions about people",
            "Large-table nearest neighbors, top-k retrieval or transposition distance",
            "Network requests, file changes, external execution, publishing or deployment"
          ],
          "capabilities": [
            "Exact unit-cost scalar Levenshtein over every cross pair and field; no pruning or truncation",
            "Unicode normalization then ASCII lowercase then ASCII whitespace collapse/trim, each explicitly selected",
            "Unicode normalization supplied by the pinned Worker runtime; NFKC can erase meaningful distinctions",
            "Candidate sort: exact UTF-16 left ID, numeric cost, exact UTF-16 right ID; IDs are never normalized",
            "Complete bounded result computed during semantic preflight before payment challenge; recomputed during execution",
            "Supplied-data-only artifact; externalRequests=0"
          ],
          "related": [
            "records-project",
            "records-join",
            "assignment-cost-optimize"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 20,
            "dpCells": 262144,
            "rowsPerSide": 16,
            "fields": 3,
            "valueScalars": 128,
            "idCodeUnits": 80,
            "weight": 100,
            "maxWeightedDistance": 38400,
            "candidates": 256,
            "comparisonUnit": "unicode-scalars",
            "normalizationOrder": "unicodeForm,asciiCase,asciiWhitespace",
            "candidateSet": "complete-for-declared-rules"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "WORK_LIMIT",
            "DUPLICATE_ID",
            "FIELD_WIDTH",
            "VALUE_LENGTH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "left": {
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "values": {
                          "minItems": 1,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 256
                          }
                        }
                      },
                      "required": [
                        "id",
                        "values"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "right": {
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "values": {
                          "minItems": 1,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 256
                          }
                        }
                      },
                      "required": [
                        "id",
                        "values"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "fields": {
                    "minItems": 1,
                    "maxItems": 3,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "weight": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100
                        },
                        "maxDistance": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 128
                        },
                        "normalization": {
                          "type": "object",
                          "properties": {
                            "unicodeForm": {
                              "type": "string",
                              "enum": [
                                "none",
                                "NFC",
                                "NFKC"
                              ]
                            },
                            "asciiCase": {
                              "type": "string",
                              "enum": [
                                "preserve",
                                "lower"
                              ]
                            },
                            "asciiWhitespace": {
                              "type": "string",
                              "enum": [
                                "preserve",
                                "collapse-trim"
                              ]
                            }
                          },
                          "required": [
                            "unicodeForm",
                            "asciiCase",
                            "asciiWhitespace"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "id",
                        "weight",
                        "maxDistance",
                        "normalization"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "maxWeightedDistance": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 38400
                  }
                },
                "required": [
                  "left",
                  "right",
                  "fields",
                  "maxWeightedDistance"
                ],
                "additionalProperties": false
              },
              "example": {
                "fields": [
                  {
                    "id": "label",
                    "weight": 2,
                    "maxDistance": 2,
                    "normalization": {
                      "unicodeForm": "NFC",
                      "asciiCase": "lower",
                      "asciiWhitespace": "collapse-trim"
                    }
                  },
                  {
                    "id": "family",
                    "weight": 1,
                    "maxDistance": 0,
                    "normalization": {
                      "unicodeForm": "NFC",
                      "asciiCase": "lower",
                      "asciiWhitespace": "collapse-trim"
                    }
                  }
                ],
                "maxWeightedDistance": 4,
                "left": [
                  {
                    "id": "L1",
                    "values": [
                      " Axle  12 ",
                      "CHASSIS"
                    ]
                  },
                  {
                    "id": "L2",
                    "values": [
                      "pump",
                      "fluid"
                    ]
                  }
                ],
                "right": [
                  {
                    "id": "R1",
                    "values": [
                      "axle 12",
                      "chassis"
                    ]
                  },
                  {
                    "id": "R2",
                    "values": [
                      "axel 12",
                      "chassis"
                    ]
                  },
                  {
                    "id": "R3",
                    "values": [
                      "pump",
                      "fluid"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-link-candidates",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "explicit-normalized-levenshtein-candidates-v1"
                        },
                        "fields": {
                          "minItems": 1,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "weight": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100
                              },
                              "maxDistance": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 128
                              },
                              "normalization": {
                                "type": "object",
                                "properties": {
                                  "unicodeForm": {
                                    "type": "string",
                                    "enum": [
                                      "none",
                                      "NFC",
                                      "NFKC"
                                    ]
                                  },
                                  "asciiCase": {
                                    "type": "string",
                                    "enum": [
                                      "preserve",
                                      "lower"
                                    ]
                                  },
                                  "asciiWhitespace": {
                                    "type": "string",
                                    "enum": [
                                      "preserve",
                                      "collapse-trim"
                                    ]
                                  }
                                },
                                "required": [
                                  "unicodeForm",
                                  "asciiCase",
                                  "asciiWhitespace"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "id",
                              "weight",
                              "maxDistance",
                              "normalization"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "maxWeightedDistance": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 38400
                        },
                        "normalizedLeft": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "values": {
                                "minItems": 1,
                                "maxItems": 3,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "maxLength": 256
                                }
                              }
                            },
                            "required": [
                              "id",
                              "values"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "normalizedRight": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "values": {
                                "minItems": 1,
                                "maxItems": 3,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "maxLength": 256
                                }
                              }
                            },
                            "required": [
                              "id",
                              "values"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "candidates": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "leftId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "rightId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "fieldDistances": {
                                "minItems": 1,
                                "maxItems": 3,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "fieldId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 80
                                    },
                                    "distance": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 128
                                    },
                                    "weightedDistance": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 12800
                                    }
                                  },
                                  "required": [
                                    "fieldId",
                                    "distance",
                                    "weightedDistance"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "cost": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "required": [
                              "leftId",
                              "rightId",
                              "fieldDistances",
                              "cost"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "perLeft": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "leftId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "candidateCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 16
                              },
                              "minimumCost": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "bestRightIds": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              }
                            },
                            "required": [
                              "leftId",
                              "candidateCount",
                              "minimumCost",
                              "bestRightIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "noCandidateLeftIds": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 80
                          }
                        },
                        "pairComparisonCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 256
                        },
                        "fieldComparisonCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 768
                        },
                        "dpCellCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 262144
                        },
                        "candidateSetComplete": {
                          "type": "boolean",
                          "const": true
                        },
                        "identityResolved": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "fields",
                        "maxWeightedDistance",
                        "normalizedLeft",
                        "normalizedRight",
                        "candidates",
                        "perLeft",
                        "noCandidateLeftIds",
                        "pairComparisonCount",
                        "fieldComparisonCount",
                        "dpCellCount",
                        "candidateSetComplete",
                        "identityResolved",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-link-candidates",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-normalized-levenshtein-candidates-v1",
                    "fields": [
                      {
                        "id": "label",
                        "weight": 2,
                        "maxDistance": 2,
                        "normalization": {
                          "unicodeForm": "NFC",
                          "asciiCase": "lower",
                          "asciiWhitespace": "collapse-trim"
                        }
                      },
                      {
                        "id": "family",
                        "weight": 1,
                        "maxDistance": 0,
                        "normalization": {
                          "unicodeForm": "NFC",
                          "asciiCase": "lower",
                          "asciiWhitespace": "collapse-trim"
                        }
                      }
                    ],
                    "maxWeightedDistance": 4,
                    "normalizedLeft": [
                      {
                        "id": "L1",
                        "values": [
                          "axle 12",
                          "chassis"
                        ]
                      },
                      {
                        "id": "L2",
                        "values": [
                          "pump",
                          "fluid"
                        ]
                      }
                    ],
                    "normalizedRight": [
                      {
                        "id": "R1",
                        "values": [
                          "axle 12",
                          "chassis"
                        ]
                      },
                      {
                        "id": "R2",
                        "values": [
                          "axel 12",
                          "chassis"
                        ]
                      },
                      {
                        "id": "R3",
                        "values": [
                          "pump",
                          "fluid"
                        ]
                      }
                    ],
                    "candidates": [
                      {
                        "leftId": "L1",
                        "rightId": "R1",
                        "fieldDistances": [
                          {
                            "fieldId": "label",
                            "distance": 0,
                            "weightedDistance": 0
                          },
                          {
                            "fieldId": "family",
                            "distance": 0,
                            "weightedDistance": 0
                          }
                        ],
                        "cost": "0"
                      },
                      {
                        "leftId": "L1",
                        "rightId": "R2",
                        "fieldDistances": [
                          {
                            "fieldId": "label",
                            "distance": 2,
                            "weightedDistance": 4
                          },
                          {
                            "fieldId": "family",
                            "distance": 0,
                            "weightedDistance": 0
                          }
                        ],
                        "cost": "4"
                      },
                      {
                        "leftId": "L2",
                        "rightId": "R3",
                        "fieldDistances": [
                          {
                            "fieldId": "label",
                            "distance": 0,
                            "weightedDistance": 0
                          },
                          {
                            "fieldId": "family",
                            "distance": 0,
                            "weightedDistance": 0
                          }
                        ],
                        "cost": "0"
                      }
                    ],
                    "perLeft": [
                      {
                        "leftId": "L1",
                        "candidateCount": 2,
                        "minimumCost": "0",
                        "bestRightIds": [
                          "R1"
                        ]
                      },
                      {
                        "leftId": "L2",
                        "candidateCount": 1,
                        "minimumCost": "0",
                        "bestRightIds": [
                          "R3"
                        ]
                      }
                    ],
                    "noCandidateLeftIds": [],
                    "pairComparisonCount": 6,
                    "fieldComparisonCount": 12,
                    "dpCellCount": 581,
                    "candidateSetComplete": true,
                    "identityResolved": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "588279a822903512cb726f70c274fe5639f800e1c38cb18a1f1212977f108aa1",
                    "outputSha256": "066667d2abaa77c4727ecf26453c0db3274d95e1008d452b7555be3af7f429eb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/text-edit-align": {
      "post": {
        "operationId": "x402_text_edit_align",
        "summary": "Exact Scalar Text Edit Alignment",
        "description": "Generate a minimum unit-edit alignment of two supplied short texts with deterministic ties, scalar/UTF-16/UTF-8 spans, exact digests and a fully guarded text-edits-apply request. Preserves every supplied scalar and newline without normalization.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-edit-align.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate guarded text edits from two short exact text versions",
            "Align scalar changes with Unicode byte and code-unit offset evidence"
          ],
          "whenToUse": [
            "Produce a complete reproducible minimum unit-edit script and consumer-ready guarded edit request"
          ],
          "whenNotToUse": [
            "Line, token, grapheme or semantic alignment; fuzzy anchoring or transposition distance",
            "Long documents or more than 200 separated changed blocks",
            "Network requests, file changes, external execution, publishing or deployment"
          ],
          "capabilities": [
            "Suffix DP with optimal step precedence equal, substitute, delete, insert",
            "Coalesce adjacent equal steps only; every non-equal step stays scalar-granular",
            "Guarded edits group maximal contiguous non-equal blocks without crossing equal text",
            "Actual consumer input schema and complete generated-input semantic checks before challenge; consumer purchase/execution remains separate",
            "Exact UTF-8 SHA-256 provenance; no normalization, trimming or newline conversion",
            "Complete bounded result computed during semantic preflight before payment challenge; recomputed during execution",
            "Supplied-data-only artifact; externalRequests=0"
          ],
          "related": [
            "text-edits-apply",
            "text-offset-map",
            "lines-diff"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 20,
            "dpCells": 262144,
            "textScalars": 512,
            "atomicSteps": 1024,
            "editBlocks": 200,
            "editOffsetUnit": "utf16-code-units",
            "alignmentUnit": "unicode-scalars",
            "tieOrder": "equal,substitute,delete,insert"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "WORK_LIMIT",
            "TEXT_LENGTH",
            "EDIT_BLOCK_LIMIT",
            "CONSUMER_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "before": {
                    "type": "string",
                    "maxLength": 1024
                  },
                  "after": {
                    "type": "string",
                    "maxLength": 1024
                  }
                },
                "required": [
                  "before",
                  "after"
                ],
                "additionalProperties": false
              },
              "example": {
                "before": "A😀cat\n",
                "after": "A😀cut!\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-edit-align",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "scalar-unit-edit-alignment-v1"
                        },
                        "tieOrder": {
                          "type": "array",
                          "prefixItems": [
                            {
                              "type": "string",
                              "const": "equal"
                            },
                            {
                              "type": "string",
                              "const": "substitute"
                            },
                            {
                              "type": "string",
                              "const": "delete"
                            },
                            {
                              "type": "string",
                              "const": "insert"
                            }
                          ],
                          "items": false,
                          "minItems": 4,
                          "maxItems": 4
                        },
                        "distance": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 512
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "insertions": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 512
                            },
                            "deletions": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 512
                            },
                            "substitutions": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 512
                            }
                          },
                          "required": [
                            "insertions",
                            "deletions",
                            "substitutions"
                          ],
                          "additionalProperties": false
                        },
                        "before": {
                          "type": "object",
                          "properties": {
                            "scalar": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 512
                            },
                            "utf16": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1024
                            },
                            "utf8": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 2048
                            }
                          },
                          "required": [
                            "scalar",
                            "utf16",
                            "utf8"
                          ],
                          "additionalProperties": false
                        },
                        "after": {
                          "type": "object",
                          "properties": {
                            "scalar": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 512
                            },
                            "utf16": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1024
                            },
                            "utf8": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 2048
                            }
                          },
                          "required": [
                            "scalar",
                            "utf16",
                            "utf8"
                          ],
                          "additionalProperties": false
                        },
                        "beforeSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "afterSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "digestEncoding": {
                          "type": "string",
                          "const": "exact-utf8"
                        },
                        "dpCellCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 262144
                        },
                        "operations": {
                          "maxItems": 1024,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "op": {
                                "type": "string",
                                "enum": [
                                  "equal",
                                  "substitute",
                                  "delete",
                                  "insert"
                                ]
                              },
                              "source": {
                                "type": "object",
                                "properties": {
                                  "scalar": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  },
                                  "utf16": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  },
                                  "utf8": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  }
                                },
                                "required": [
                                  "scalar",
                                  "utf16",
                                  "utf8"
                                ],
                                "additionalProperties": false
                              },
                              "target": {
                                "type": "object",
                                "properties": {
                                  "scalar": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  },
                                  "utf16": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  },
                                  "utf8": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  }
                                },
                                "required": [
                                  "scalar",
                                  "utf16",
                                  "utf8"
                                ],
                                "additionalProperties": false
                              },
                              "sourceText": {
                                "type": "string"
                              },
                              "targetText": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "op",
                              "source",
                              "target",
                              "sourceText",
                              "targetText"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "applyRequest": {
                          "type": "object",
                          "properties": {
                            "text": {
                              "type": "string"
                            },
                            "expectedSha256": {
                              "type": "string",
                              "pattern": "^[0-9a-f]{64}$"
                            },
                            "edits": {
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 80
                                  },
                                  "start": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "end": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "expected": {
                                    "type": "string"
                                  },
                                  "replacement": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "start",
                                  "end",
                                  "expected",
                                  "replacement"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "text",
                            "expectedSha256",
                            "edits"
                          ],
                          "additionalProperties": false
                        },
                        "consumerValidated": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "tieOrder",
                        "distance",
                        "counts",
                        "before",
                        "after",
                        "beforeSha256",
                        "afterSha256",
                        "digestEncoding",
                        "dpCellCount",
                        "operations",
                        "applyRequest",
                        "consumerValidated",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-edit-align",
                  "version": "0.29.0",
                  "result": {
                    "profile": "scalar-unit-edit-alignment-v1",
                    "tieOrder": [
                      "equal",
                      "substitute",
                      "delete",
                      "insert"
                    ],
                    "distance": 2,
                    "counts": {
                      "insertions": 1,
                      "deletions": 0,
                      "substitutions": 1
                    },
                    "before": {
                      "scalar": 6,
                      "utf16": 7,
                      "utf8": 9
                    },
                    "after": {
                      "scalar": 7,
                      "utf16": 8,
                      "utf8": 10
                    },
                    "beforeSha256": "c413f26d179faf31f2918a1c080a2004c7ee7f9bee8f1a2138342a9d56e078b6",
                    "afterSha256": "adcffe9889029b9ee89f1d701983df061893f2e639ff91db6ffcad296cff2911",
                    "digestEncoding": "exact-utf8",
                    "dpCellCount": 56,
                    "operations": [
                      {
                        "op": "equal",
                        "source": {
                          "scalar": [
                            0,
                            3
                          ],
                          "utf16": [
                            0,
                            4
                          ],
                          "utf8": [
                            0,
                            6
                          ]
                        },
                        "target": {
                          "scalar": [
                            0,
                            3
                          ],
                          "utf16": [
                            0,
                            4
                          ],
                          "utf8": [
                            0,
                            6
                          ]
                        },
                        "sourceText": "A😀c",
                        "targetText": "A😀c"
                      },
                      {
                        "op": "substitute",
                        "source": {
                          "scalar": [
                            3,
                            4
                          ],
                          "utf16": [
                            4,
                            5
                          ],
                          "utf8": [
                            6,
                            7
                          ]
                        },
                        "target": {
                          "scalar": [
                            3,
                            4
                          ],
                          "utf16": [
                            4,
                            5
                          ],
                          "utf8": [
                            6,
                            7
                          ]
                        },
                        "sourceText": "a",
                        "targetText": "u"
                      },
                      {
                        "op": "equal",
                        "source": {
                          "scalar": [
                            4,
                            5
                          ],
                          "utf16": [
                            5,
                            6
                          ],
                          "utf8": [
                            7,
                            8
                          ]
                        },
                        "target": {
                          "scalar": [
                            4,
                            5
                          ],
                          "utf16": [
                            5,
                            6
                          ],
                          "utf8": [
                            7,
                            8
                          ]
                        },
                        "sourceText": "t",
                        "targetText": "t"
                      },
                      {
                        "op": "insert",
                        "source": {
                          "scalar": [
                            5,
                            5
                          ],
                          "utf16": [
                            6,
                            6
                          ],
                          "utf8": [
                            8,
                            8
                          ]
                        },
                        "target": {
                          "scalar": [
                            5,
                            6
                          ],
                          "utf16": [
                            6,
                            7
                          ],
                          "utf8": [
                            8,
                            9
                          ]
                        },
                        "sourceText": "",
                        "targetText": "!"
                      },
                      {
                        "op": "equal",
                        "source": {
                          "scalar": [
                            5,
                            6
                          ],
                          "utf16": [
                            6,
                            7
                          ],
                          "utf8": [
                            8,
                            9
                          ]
                        },
                        "target": {
                          "scalar": [
                            6,
                            7
                          ],
                          "utf16": [
                            7,
                            8
                          ],
                          "utf8": [
                            9,
                            10
                          ]
                        },
                        "sourceText": "\n",
                        "targetText": "\n"
                      }
                    ],
                    "applyRequest": {
                      "text": "A😀cat\n",
                      "expectedSha256": "c413f26d179faf31f2918a1c080a2004c7ee7f9bee8f1a2138342a9d56e078b6",
                      "edits": [
                        {
                          "id": "e000",
                          "start": 4,
                          "end": 5,
                          "expected": "a",
                          "replacement": "u"
                        },
                        {
                          "id": "e001",
                          "start": 6,
                          "end": 6,
                          "expected": "",
                          "replacement": "!"
                        }
                      ]
                    },
                    "consumerValidated": true,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "f90c8be8123103b347d0ea86db5571ec73dfb0a46de190ba7f761b4787aa2cad",
                    "outputSha256": "346e06c8ac2c43944f12e853e875b8d69f68f31225ee4b36876ffc2c2b278d7a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/checked-json-artifact": {
      "post": {
        "operationId": "x402_checked_json_artifact",
        "summary": "Checked JSON Artifact Bundle",
        "description": "Repair one JSON document, require a valid caller-schema result, serialize and SHA-256 hash it before one x402 settlement. Fixed four-step local profile; no partial result, RFC 8785 or guaranteed delivery.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/checked-json-artifact.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Repair, schema-check, serialize and hash one JSON document before one service charge",
            "Produce a checked JSON artifact with its exact UTF-8 SHA-256 and reviewable repair evidence"
          ],
          "whenToUse": [
            "The caller needs all four successful local steps as one x402-only fixed job",
            "Withhold partial results and stop before new settlement if repair or schema acceptance fails"
          ],
          "whenNotToUse": [
            "Arbitrary workflows, operation lists, bindings, external requests, MPP, or per-step pricing",
            "Only repair, only validation, or a job that does not need an artifact digest",
            "Full JSON Schema, RFC 8785, semantic truth, authenticity or guaranteed delivery"
          ],
          "capabilities": [
            "Exactly four trusted local components, one fixed proposed total and one outer protocol receipt",
            "Caller-owned safe-json-schema-subset-v1 gate; false/rejected reports abort the bundle",
            "Full repair original and edit evidence only in the complete successful result",
            "Artifact SHA-256 differs from the outer result-packet provenance hash",
            "Payment and response-delivery uncertainty require reconciliation using the original request identity"
          ],
          "related": [
            "json-repair",
            "json-schema-check",
            "json-canonicalize",
            "content-digest"
          ],
          "limits": {
            "steps": 4,
            "sourceItems": 1,
            "bindings": 3,
            "inputBytes": 32768,
            "sourceCodeUnits": 8000,
            "sourceBytesUtf8": 16000,
            "schemaBytes": 8192,
            "schemaNodes": 64,
            "schemaDepth": 8,
            "combinatorMembers": 4,
            "enumConstBytes": 8192,
            "valueNodes": 2000,
            "valueDepth": 16,
            "valueCollectionEntries": 256,
            "repairEdits": 100,
            "resolvedInputBytes": 32768,
            "resolvedInputNodes": 4000,
            "resolvedInputDepth": 20,
            "intermediateOutputBytes": 65536,
            "aggregateBytes": 196608,
            "aggregateNodes": 16000,
            "outputBytes": 131072,
            "jsonDepth": 24,
            "jsonNodes": 16000,
            "profile": "checked-json-artifact-v1",
            "networkAccess": "none-for-local-transformations",
            "schemaDialect": "safe-json-schema-subset-v1",
            "serializationProfile": "sorted-key-javascript-json-not-rfc8785",
            "paymentProtocol": "x402-only",
            "priceStatus": "proposed-unverified",
            "delivery": "not-guaranteed"
          },
          "errorCodes": [
            "BUNDLE_INPUT_LIMIT",
            "BUNDLE_PROFILE_INVALID",
            "BUNDLE_REPAIR_REJECTED",
            "BUNDLE_SCHEMA_REJECTED",
            "BUNDLE_STEP_INVALID",
            "BUNDLE_WORK_LIMIT",
            "BUNDLE_OUTPUT_LIMIT",
            "BUNDLE_INTERNAL_CONTRACT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "const": "checked-json-artifact-v1"
                  },
                  "steps": {
                    "type": "array",
                    "prefixItems": [
                      {
                        "type": "object",
                        "properties": {
                          "id": {
                            "const": "repair"
                          },
                          "operation": {
                            "const": "json-repair"
                          },
                          "input": {
                            "type": "object",
                            "properties": {
                              "profile": {
                                "const": "conservative-json-repair-v1"
                              },
                              "items": {
                                "type": "array",
                                "prefixItems": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "const": "document"
                                      },
                                      "text": {
                                        "type": "string",
                                        "maxLength": 8000
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "text"
                                    ],
                                    "additionalProperties": false
                                  }
                                ],
                                "items": false,
                                "minItems": 1
                              }
                            },
                            "required": [
                              "profile",
                              "items"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "id",
                          "operation",
                          "input"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "id": {
                            "const": "validate"
                          },
                          "operation": {
                            "const": "json-schema-check"
                          },
                          "input": {
                            "type": "object",
                            "properties": {
                              "schema": {
                                "$ref": "#/paths/~1v1~1x402~1checked-json-artifact/post/requestBody/content/application~1json/schema/$defs/__schema0"
                              }
                            },
                            "required": [
                              "schema"
                            ],
                            "additionalProperties": false
                          },
                          "bindings": {
                            "const": [
                              {
                                "target": "/value",
                                "from": {
                                  "step": "repair",
                                  "pointer": "/results/0/value"
                                }
                              }
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "operation",
                          "input",
                          "bindings"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "const": {
                          "id": "serialize",
                          "operation": "json-canonicalize",
                          "input": {},
                          "bindings": [
                            {
                              "target": "/value",
                              "from": {
                                "step": "repair",
                                "pointer": "/results/0/value"
                              }
                            }
                          ]
                        }
                      },
                      {
                        "const": {
                          "id": "digest",
                          "operation": "content-digest",
                          "input": {
                            "algorithm": "SHA-256"
                          },
                          "bindings": [
                            {
                              "target": "/text",
                              "from": {
                                "step": "serialize",
                                "pointer": "/canonical"
                              }
                            }
                          ]
                        }
                      }
                    ],
                    "items": false,
                    "minItems": 4
                  }
                },
                "required": [
                  "profile",
                  "steps"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1x402~1checked-json-artifact/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1x402~1checked-json-artifact/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "profile": "checked-json-artifact-v1",
                "steps": [
                  {
                    "id": "repair",
                    "operation": "json-repair",
                    "input": {
                      "profile": "conservative-json-repair-v1",
                      "items": [
                        {
                          "id": "document",
                          "text": "True"
                        }
                      ]
                    }
                  },
                  {
                    "id": "validate",
                    "operation": "json-schema-check",
                    "input": {
                      "schema": {
                        "type": "boolean"
                      }
                    },
                    "bindings": [
                      {
                        "target": "/value",
                        "from": {
                          "step": "repair",
                          "pointer": "/results/0/value"
                        }
                      }
                    ]
                  },
                  {
                    "id": "serialize",
                    "operation": "json-canonicalize",
                    "input": {},
                    "bindings": [
                      {
                        "target": "/value",
                        "from": {
                          "step": "repair",
                          "pointer": "/results/0/value"
                        }
                      }
                    ]
                  },
                  {
                    "id": "digest",
                    "operation": "content-digest",
                    "input": {
                      "algorithm": "SHA-256"
                    },
                    "bindings": [
                      {
                        "target": "/text",
                        "from": {
                          "step": "serialize",
                          "pointer": "/canonical"
                        }
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "checked-json-artifact",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "const": "checked-json-artifact-v1"
                        },
                        "status": {
                          "const": "complete"
                        },
                        "stepCount": {
                          "const": 4
                        },
                        "steps": {
                          "type": "array",
                          "prefixItems": [
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "const": "repair"
                                },
                                "operation": {
                                  "const": "json-repair"
                                },
                                "result": {
                                  "type": "object",
                                  "properties": {
                                    "profile": {
                                      "const": "conservative-json-repair-v1"
                                    },
                                    "offsetUnit": {
                                      "const": "utf16-code-units"
                                    },
                                    "itemCount": {
                                      "const": 1
                                    },
                                    "successCount": {
                                      "const": 1
                                    },
                                    "rejectedCount": {
                                      "const": 0
                                    },
                                    "results": {
                                      "type": "array",
                                      "prefixItems": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "const": "document"
                                            },
                                            "originalText": {
                                              "type": "string"
                                            },
                                            "status": {
                                              "type": "string",
                                              "enum": [
                                                "repaired",
                                                "unchanged"
                                              ]
                                            },
                                            "originalSha256": {
                                              "type": "string",
                                              "pattern": "^[a-f0-9]{64}$"
                                            },
                                            "originalWasValidJson": {
                                              "type": "boolean"
                                            },
                                            "repairedText": {
                                              "type": "string"
                                            },
                                            "repairedSha256": {
                                              "type": "string",
                                              "pattern": "^[a-f0-9]{64}$"
                                            },
                                            "value": {
                                              "$ref": "#/paths/~1v1~1x402~1checked-json-artifact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                            },
                                            "edits": {
                                              "maxItems": 100,
                                              "type": "array",
                                              "items": {
                                                "type": "object",
                                                "properties": {
                                                  "kind": {
                                                    "type": "string",
                                                    "enum": [
                                                      "remove-bom",
                                                      "remove-fence",
                                                      "replace-comment",
                                                      "remove-trailing-comma",
                                                      "quote-key",
                                                      "convert-single-quoted-string",
                                                      "convert-python-literal"
                                                    ]
                                                  },
                                                  "start": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "end": {
                                                    "type": "integer",
                                                    "minimum": 0,
                                                    "maximum": 9007199254740991
                                                  },
                                                  "before": {
                                                    "type": "string"
                                                  },
                                                  "after": {
                                                    "type": "string"
                                                  }
                                                },
                                                "required": [
                                                  "kind",
                                                  "start",
                                                  "end",
                                                  "before",
                                                  "after"
                                                ],
                                                "additionalProperties": false
                                              }
                                            }
                                          },
                                          "required": [
                                            "id",
                                            "originalText",
                                            "status",
                                            "originalSha256",
                                            "originalWasValidJson",
                                            "repairedText",
                                            "repairedSha256",
                                            "value",
                                            "edits"
                                          ],
                                          "additionalProperties": false
                                        }
                                      ],
                                      "items": false,
                                      "minItems": 1
                                    }
                                  },
                                  "required": [
                                    "profile",
                                    "offsetUnit",
                                    "itemCount",
                                    "successCount",
                                    "rejectedCount",
                                    "results"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "required": [
                                "id",
                                "operation",
                                "result"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "const": "validate"
                                },
                                "operation": {
                                  "const": "json-schema-check"
                                },
                                "result": {
                                  "type": "object",
                                  "properties": {
                                    "valid": {
                                      "const": true
                                    },
                                    "errors": {
                                      "maxItems": 0,
                                      "type": "array",
                                      "items": {
                                        "not": {}
                                      }
                                    },
                                    "dialect": {
                                      "const": "safe-json-schema-subset-v1"
                                    }
                                  },
                                  "required": [
                                    "valid",
                                    "errors",
                                    "dialect"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "required": [
                                "id",
                                "operation",
                                "result"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "const": "serialize"
                                },
                                "operation": {
                                  "const": "json-canonicalize"
                                },
                                "result": {
                                  "type": "object",
                                  "properties": {
                                    "canonical": {
                                      "type": "string",
                                      "maxLength": 100000
                                    },
                                    "bytesUtf8": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "canonical",
                                    "bytesUtf8"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "required": [
                                "id",
                                "operation",
                                "result"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "const": "digest"
                                },
                                "operation": {
                                  "const": "content-digest"
                                },
                                "result": {
                                  "type": "object",
                                  "properties": {
                                    "algorithm": {
                                      "const": "SHA-256"
                                    },
                                    "hex": {
                                      "type": "string",
                                      "pattern": "^[a-f0-9]{64}$"
                                    },
                                    "base64": {
                                      "type": "string",
                                      "pattern": "^[A-Za-z0-9+/]{43}=$"
                                    },
                                    "byteLength": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "algorithm",
                                    "hex",
                                    "base64",
                                    "byteLength"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "required": [
                                "id",
                                "operation",
                                "result"
                              ],
                              "additionalProperties": false
                            }
                          ],
                          "items": false,
                          "minItems": 4
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "stepCount",
                        "steps",
                        "externalRequests"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1x402~1checked-json-artifact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1x402~1checked-json-artifact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "checked-json-artifact",
                  "version": "0.29.0",
                  "result": {
                    "profile": "checked-json-artifact-v1",
                    "status": "complete",
                    "stepCount": 4,
                    "steps": [
                      {
                        "id": "repair",
                        "operation": "json-repair",
                        "result": {
                          "profile": "conservative-json-repair-v1",
                          "offsetUnit": "utf16-code-units",
                          "itemCount": 1,
                          "successCount": 1,
                          "rejectedCount": 0,
                          "results": [
                            {
                              "id": "document",
                              "originalText": "True",
                              "status": "repaired",
                              "originalSha256": "3cbc87c7681f34db4617feaa2c8801931bc5e42d8d0f560e756dd4cd92885f18",
                              "originalWasValidJson": false,
                              "repairedText": "true",
                              "repairedSha256": "b5bea41b6c623f7c09f1bf24dcae58ebab3c0cdd90ad966bc43a45b44867e12b",
                              "value": true,
                              "edits": [
                                {
                                  "kind": "convert-python-literal",
                                  "start": 0,
                                  "end": 4,
                                  "before": "True",
                                  "after": "true"
                                }
                              ]
                            }
                          ]
                        }
                      },
                      {
                        "id": "validate",
                        "operation": "json-schema-check",
                        "result": {
                          "valid": true,
                          "errors": [],
                          "dialect": "safe-json-schema-subset-v1"
                        }
                      },
                      {
                        "id": "serialize",
                        "operation": "json-canonicalize",
                        "result": {
                          "canonical": "true",
                          "bytesUtf8": 4
                        }
                      },
                      {
                        "id": "digest",
                        "operation": "content-digest",
                        "result": {
                          "algorithm": "SHA-256",
                          "hex": "b5bea41b6c623f7c09f1bf24dcae58ebab3c0cdd90ad966bc43a45b44867e12b",
                          "base64": "tb6kG2xiP3wJ8b8k3K5Y66s8DN2QrZZrxDpFtEhn4Ss=",
                          "byteLength": 4
                        }
                      }
                    ],
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "978b1678c043303983abb687f36066ac3901dd8cc25faad57c5b549bdd20d606",
                    "outputSha256": "0ce678cb0e4d06c619e9da513aea8a2e9c162bdf8c513bff1ebc48b4b1b9735a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.016",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/json-jcs-canonicalize": {
      "post": {
        "operationId": "x402_json_jcs_canonicalize",
        "summary": "JCS JSON Source Canonicalizer",
        "description": "Canonicalize strict supplied JSON source with duplicate-name, Unicode and binary64 admission to bounded RFC 8785-compatible UTF-8 text and SHA-256. No signing, authenticity, authorization or lossless decimal guarantee.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-jcs-canonicalize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "canonicalize strict JSON source to RFC 8785 bytes",
            "detect duplicate JSON names before canonicalization",
            "prepare JCS binary64 artifacts for offline consumers"
          ],
          "whenToUse": [
            "An external consumer explicitly requires the bounded jcs-rfc8785-source-binary64-v1 profile",
            "Source JSON must retain duplicate-member visibility and recursively sorted UTF-16 object keys"
          ],
          "whenNotToUse": [
            "Lossless arbitrary-precision decimal or large-integer semantics; represent such data as strings",
            "Repairing JSON, authorizing actions, signing, authenticating authors or proving content correctness",
            "Secrets or personal data that must not be disclosed; unsalted artifact hashes do not anonymize inputs"
          ],
          "capabilities": [
            "Strict raw-source grammar; escaped duplicate names rejected before ordinary object construction",
            "Rejects negative zero per verified erratum 7920, underflow-to-zero, nonfinite numbers, lone surrogates and Unicode noncharacters",
            "Exact canonical UTF-8 length and SHA-256; arrays and Unicode normalization distinctions preserved",
            "Deterministic supplied-input-only operation without network, clock or randomness"
          ],
          "related": [
            "json-canonicalize",
            "http-signature-base-compose",
            "content-digest"
          ],
          "limits": {
            "inputBytes": 16384,
            "jsonNodes": 1024,
            "depth": 12,
            "sourceBytes": 8192,
            "outputBytes": 200000,
            "canonicalBytes": 8192,
            "sourceNodes": 1024,
            "sourceDepth": 32,
            "collectionEntries": 256,
            "keyBytes": 1024,
            "numberTokenBytes": 128,
            "profile": "jcs-rfc8785-source-binary64-v1"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON_SOURCE",
            "DUPLICATE_MEMBER",
            "INVALID_UNICODE",
            "NUMBER_DOMAIN",
            "NEGATIVE_ZERO",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "source": {
                    "type": "string",
                    "maxLength": 8192
                  },
                  "numberMode": {
                    "type": "string",
                    "const": "binary64"
                  }
                },
                "required": [
                  "source",
                  "numberMode"
                ],
                "additionalProperties": false
              },
              "example": {
                "source": "{\"2\":2,\"10\":10,\"a\":0,\"é\":\"e\\u0301\"}",
                "numberMode": "binary64"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-jcs-canonicalize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "jcs-rfc8785-source-binary64-v1"
                        },
                        "canonical": {
                          "type": "string",
                          "maxLength": 8192
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 8192
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$(?![\\s\\S])"
                        },
                        "numberMode": {
                          "type": "string",
                          "const": "binary64"
                        }
                      },
                      "required": [
                        "profile",
                        "canonical",
                        "byteLength",
                        "sha256",
                        "numberMode"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-jcs-canonicalize",
                  "version": "0.29.0",
                  "result": {
                    "profile": "jcs-rfc8785-source-binary64-v1",
                    "canonical": "{\"10\":10,\"2\":2,\"a\":0,\"é\":\"é\"}",
                    "byteLength": 32,
                    "sha256": "fc981f41457715bc2aaca00e3153740b569f2a19593fdd4839734c78d5414af4",
                    "numberMode": "binary64"
                  },
                  "provenance": {
                    "inputSha256": "02411289e3c3a2332abe689ed36f95795c49c60a38aed30d77663bbcf8effff7",
                    "outputSha256": "fa07ed8840b1c50f9e1d9bb50aaf6356db96a4f52c6605a581381f4f97773977",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/http-signature-base-compose": {
      "post": {
        "operationId": "x402_http_signature_base_compose",
        "summary": "Compose an HTTP request signature base",
        "description": "Compose inert ASCII RFC 9421 request signature-base and Signature-Input artifacts from ordered, supplied non-secret field examples and explicit context. Does not sign, verify, authorize or send requests.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-signature-base-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compose an HTTP request signature base",
            "extract ordered RFC 9421 request components"
          ],
          "whenToUse": [
            "Build an inert signature-base example from supplied request context and ordered ASCII field lines",
            "Compare raw and binary-wrapped field boundaries before using an external signer"
          ],
          "whenNotToUse": [
            "Signing, verification, keys, credentials, authentication, authorization, payment, or live HTTP requests",
            "Responses, trailers, CONNECT, query-parameter selection, Structured Field parsing, Unicode or obs-text fields",
            "Secret or production request payloads, including secrets in targets, free text or key identifiers"
          ],
          "capabilities": [
            "Ordered field provenance and per-line binary wrapping",
            "Strict bounded schema and complete semantic preflight before execution",
            "Exact ASCII artifacts, byte lengths and SHA-256 artifact hashes"
          ],
          "limits": {
            "inputBytes": 16384,
            "jsonNodes": 1024,
            "depth": 12,
            "outputBytes": 200000,
            "headerLines": 64,
            "headerNameBytes": 64,
            "headerValueBytes": 1024,
            "aggregateHeaderValueBytes": 4096,
            "targetBytes": 1024,
            "authorityBytes": 259,
            "components": 32,
            "parameters": 6,
            "labelBytes": 64,
            "signatureBaseBytes": 8192,
            "signatureInputBytes": 4096
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_UNICODE",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "OUTPUT_LIMIT",
            "INVALID_REQUEST_CONTEXT",
            "INVALID_FIELD",
            "FORBIDDEN_FIELD",
            "UNSUPPORTED_COMPONENT",
            "DUPLICATE_COMPONENT",
            "MISSING_COMPONENT",
            "AMBIGUOUS_FIELD",
            "INVALID_PARAMETER"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "request": {
                    "type": "object",
                    "properties": {
                      "method": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 32,
                        "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$(?![\\s\\S])"
                      },
                      "scheme": {
                        "type": "string",
                        "enum": [
                          "http",
                          "https"
                        ]
                      },
                      "authority": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 259,
                        "pattern": "^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?(?::[1-9][0-9]{0,4})?$(?![\\s\\S])"
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024,
                        "pattern": "^\\/(?:[A-Za-z0-9._~!$&'()*+,;=:@/-]|%[0-9A-Fa-f]{2})*(?:\\?(?:[A-Za-z0-9._~!$&'()*+,;=:@/?-]|%[0-9A-Fa-f]{2})*)?$(?![\\s\\S])"
                      },
                      "headers": {
                        "maxItems": 64,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64,
                              "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$(?![\\s\\S])"
                            },
                            "value": {
                              "type": "string",
                              "maxLength": 1024,
                              "pattern": "^[\\x09\\x20-\\x7e]*$(?![\\s\\S])"
                            }
                          },
                          "required": [
                            "name",
                            "value"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "method",
                      "scheme",
                      "authority",
                      "target",
                      "headers"
                    ],
                    "additionalProperties": false
                  },
                  "label": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64,
                    "pattern": "^[a-z*][a-z0-9_.*-]*$(?![\\s\\S])"
                  },
                  "components": {
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "derived"
                            },
                            "name": {
                              "type": "string",
                              "enum": [
                                "@method",
                                "@scheme",
                                "@authority",
                                "@target-uri",
                                "@path",
                                "@query"
                              ]
                            }
                          },
                          "required": [
                            "type",
                            "name"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "field"
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64,
                              "pattern": "^[!#$%&'*+.^_`|~0-9a-z-]+$(?![\\s\\S])"
                            },
                            "mode": {
                              "type": "string",
                              "enum": [
                                "raw",
                                "binary"
                              ]
                            }
                          },
                          "required": [
                            "type",
                            "name",
                            "mode"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  },
                  "parameters": {
                    "minItems": 1,
                    "maxItems": 6,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "enum": [
                                "created",
                                "expires"
                              ]
                            },
                            "value": {
                              "type": "string",
                              "maxLength": 15,
                              "pattern": "^(?:0|[1-9][0-9]{0,14})$(?![\\s\\S])"
                            }
                          },
                          "required": [
                            "name",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "enum": [
                                "keyid",
                                "nonce",
                                "tag"
                              ]
                            },
                            "value": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256,
                              "pattern": "^[\\x20-\\x7e]*$(?![\\s\\S])"
                            }
                          },
                          "required": [
                            "name",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "const": "alg"
                            },
                            "value": {
                              "type": "string",
                              "enum": [
                                "rsa-pss-sha512",
                                "rsa-v1_5-sha256",
                                "hmac-sha256",
                                "ecdsa-p256-sha256",
                                "ecdsa-p384-sha384",
                                "ed25519"
                              ]
                            }
                          },
                          "required": [
                            "name",
                            "value"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "request",
                  "label",
                  "components",
                  "parameters"
                ],
                "additionalProperties": false
              },
              "example": {
                "request": {
                  "method": "POST",
                  "scheme": "https",
                  "authority": "api.example.com",
                  "target": "/v1/items?limit=10",
                  "headers": [
                    {
                      "name": "Content-Type",
                      "value": "application/json"
                    },
                    {
                      "name": "Cache-Control",
                      "value": "max-age=60"
                    },
                    {
                      "name": "cache-control",
                      "value": " no-transform "
                    }
                  ]
                },
                "label": "demo",
                "components": [
                  {
                    "type": "derived",
                    "name": "@method"
                  },
                  {
                    "type": "derived",
                    "name": "@authority"
                  },
                  {
                    "type": "derived",
                    "name": "@path"
                  },
                  {
                    "type": "derived",
                    "name": "@query"
                  },
                  {
                    "type": "field",
                    "name": "content-type",
                    "mode": "raw"
                  },
                  {
                    "type": "field",
                    "name": "cache-control",
                    "mode": "raw"
                  }
                ],
                "parameters": [
                  {
                    "name": "created",
                    "value": "1700000000"
                  },
                  {
                    "name": "keyid",
                    "value": "demo-key"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-signature-base-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-sig-rfc9421-request-ascii-v1"
                        },
                        "signatureBase": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 8192,
                          "pattern": "^[\\x09\\x0a\\x20-\\x7e]*$(?![\\s\\S])"
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 8192
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$(?![\\s\\S])"
                        },
                        "signatureInput": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "const": "signature-input"
                            },
                            "value": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 4096,
                              "pattern": "^[\\x20-\\x7e]*$(?![\\s\\S])"
                            },
                            "byteLength": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 4096
                            },
                            "sha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$(?![\\s\\S])"
                            }
                          },
                          "required": [
                            "name",
                            "value",
                            "byteLength",
                            "sha256"
                          ],
                          "additionalProperties": false
                        },
                        "components": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "identifier": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 69,
                                "pattern": "^[\\x20-\\x7e]*$(?![\\s\\S])"
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 8192,
                                "pattern": "^[\\x09\\x20-\\x7e]*$(?![\\s\\S])"
                              },
                              "headerIndexes": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 63
                                }
                              }
                            },
                            "required": [
                              "identifier",
                              "value",
                              "headerIndexes"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "signatureBase",
                        "byteLength",
                        "sha256",
                        "signatureInput",
                        "components"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-signature-base-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-sig-rfc9421-request-ascii-v1",
                    "signatureBase": "\"@method\": POST\n\"@authority\": api.example.com\n\"@path\": /v1/items\n\"@query\": ?limit=10\n\"content-type\": application/json\n\"cache-control\": max-age=60, no-transform\n\"@signature-params\": (\"@method\" \"@authority\" \"@path\" \"@query\" \"content-type\" \"cache-control\");created=1700000000;keyid=\"demo-key\"",
                    "byteLength": 289,
                    "sha256": "65400d9ddc9e40a9d916cf84f6fcb158dd7a0eda5ac3aab66d0edfd12b01eb0d",
                    "signatureInput": {
                      "name": "signature-input",
                      "value": "demo=(\"@method\" \"@authority\" \"@path\" \"@query\" \"content-type\" \"cache-control\");created=1700000000;keyid=\"demo-key\"",
                      "byteLength": 113,
                      "sha256": "5f6fb3f5e0453d1599d8ae03a24e9e6052ff9180b2e0fd4533afe79e35ed5cbd"
                    },
                    "components": [
                      {
                        "identifier": "\"@method\"",
                        "value": "POST",
                        "headerIndexes": []
                      },
                      {
                        "identifier": "\"@authority\"",
                        "value": "api.example.com",
                        "headerIndexes": []
                      },
                      {
                        "identifier": "\"@path\"",
                        "value": "/v1/items",
                        "headerIndexes": []
                      },
                      {
                        "identifier": "\"@query\"",
                        "value": "?limit=10",
                        "headerIndexes": []
                      },
                      {
                        "identifier": "\"content-type\"",
                        "value": "application/json",
                        "headerIndexes": [
                          0
                        ]
                      },
                      {
                        "identifier": "\"cache-control\"",
                        "value": "max-age=60, no-transform",
                        "headerIndexes": [
                          1,
                          2
                        ]
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "4c566ce40d6d3390f029304d7fea2ae98b0f787afa766c0168a44f5132a73e57",
                    "outputSha256": "fb2b84b135aa6b57b8b49279f1c9ce1b410a052b89201d78f4322d82c88b3df3",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/http-byte-ranges-resolve": {
      "post": {
        "operationId": "x402_http_byte_ranges_resolve",
        "summary": "Resolve exact HTTP byte ranges",
        "description": "Resolve a strict supplied HTTP bytes Range field against an exact decimal representation length, retaining requested order, duplicates, unsatisfied members and half-open spans. No coalescing, server preconditions, fetching or response transmission.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-byte-ranges-resolve.md"
        },
        "x-agent-discovery": {
          "intents": [
            "resolve HTTP byte range suffix offsets",
            "exact Range header interval plan",
            "interpret byte ranges for supplied representation length"
          ],
          "whenToUse": [
            "Inspect bounded Range syntax and exact byte spans even when only a large representation length is available"
          ],
          "whenNotToUse": [
            "No remote fetching, request transmission, filesystem access, caching, content decoding or authenticity verification",
            "No server policy, method, conditional request or If-Range enforcement; callers must check applicability separately",
            "Not a full HTTP parser: unsupported units, empty list members, inner whitespace and numbers over 20 digits are rejected by this bounded profile"
          ],
          "capabilities": [
            "Exact decimal integer arithmetic up to 20 digits per coordinate",
            "Closed, open-ended and suffix ranges with input-order provenance",
            "Nonzero empty-representation suffixes remain satisfiable; selected-byte totals count overlaps and duplicates repeatedly"
          ],
          "related": [
            "http-byte-ranges-compose",
            "http-etag-evaluate",
            "interval-analyze"
          ],
          "limits": {
            "inputBytes": 16384,
            "outputBytes": 24576,
            "jsonNodes": 128,
            "depth": 4,
            "rangeBytes": 2048,
            "ranges": 16,
            "integerDigits": 20,
            "profile": "http-byte-ranges-exact-v1"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_UNICODE",
            "INVALID_RANGE",
            "INPUT_LIMIT",
            "INTEGER_LIMIT",
            "RANGE_LIMIT",
            "COMPLEXITY_LIMIT",
            "OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "range": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2048,
                    "pattern": "^[\\x09\\x20-\\x7e]+$(?![\\s\\S])"
                  },
                  "representationLength": {
                    "type": "string",
                    "maxLength": 20,
                    "pattern": "^(?:0|[1-9][0-9]{0,19})$(?![\\s\\S])"
                  }
                },
                "required": [
                  "range",
                  "representationLength"
                ],
                "additionalProperties": false
              },
              "example": {
                "range": "bytes=0-1,8-,-0,99-100",
                "representationLength": "10"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-byte-ranges-resolve",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-byte-ranges-exact-v1"
                        },
                        "representationLength": {
                          "type": "string",
                          "maxLength": 20,
                          "pattern": "^(?:0|[1-9][0-9]{0,19})$(?![\\s\\S])"
                        },
                        "normalizedRange": {
                          "type": "string",
                          "maxLength": 2048
                        },
                        "satisfiable": {
                          "type": "boolean"
                        },
                        "selectedByteLength": {
                          "type": "string",
                          "maxLength": 22,
                          "pattern": "^(?:0|[1-9][0-9]{0,21})$(?![\\s\\S])"
                        },
                        "ranges": {
                          "minItems": 1,
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 15
                              },
                              "specification": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 41
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "closed",
                                  "open",
                                  "suffix"
                                ]
                              },
                              "satisfiable": {
                                "type": "boolean"
                              },
                              "start": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 20,
                                    "pattern": "^(?:0|[1-9][0-9]{0,19})$(?![\\s\\S])"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "endExclusive": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 20,
                                    "pattern": "^(?:0|[1-9][0-9]{0,19})$(?![\\s\\S])"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "byteLength": {
                                "type": "string",
                                "maxLength": 20,
                                "pattern": "^(?:0|[1-9][0-9]{0,19})$(?![\\s\\S])"
                              }
                            },
                            "required": [
                              "index",
                              "specification",
                              "kind",
                              "satisfiable",
                              "start",
                              "endExclusive",
                              "byteLength"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "representationLength",
                        "normalizedRange",
                        "satisfiable",
                        "selectedByteLength",
                        "ranges"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-byte-ranges-resolve",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-byte-ranges-exact-v1",
                    "representationLength": "10",
                    "normalizedRange": "bytes=0-1,8-,-0,99-100",
                    "satisfiable": true,
                    "selectedByteLength": "4",
                    "ranges": [
                      {
                        "index": 0,
                        "specification": "0-1",
                        "kind": "closed",
                        "satisfiable": true,
                        "start": "0",
                        "endExclusive": "2",
                        "byteLength": "2"
                      },
                      {
                        "index": 1,
                        "specification": "8-",
                        "kind": "open",
                        "satisfiable": true,
                        "start": "8",
                        "endExclusive": "10",
                        "byteLength": "2"
                      },
                      {
                        "index": 2,
                        "specification": "-0",
                        "kind": "suffix",
                        "satisfiable": false,
                        "start": null,
                        "endExclusive": null,
                        "byteLength": "0"
                      },
                      {
                        "index": 3,
                        "specification": "99-100",
                        "kind": "closed",
                        "satisfiable": false,
                        "start": null,
                        "endExclusive": null,
                        "byteLength": "0"
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "82e7d2cada8260a948becd07c4d498e34add6f83f86cd665f2a1156bfe00ed2e",
                    "outputSha256": "0862b20b64b805b5eb418053d5643ff71bfc383c4308eca9444a5df8a578f569",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.004",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/http-byte-ranges-compose": {
      "post": {
        "operationId": "x402_http_byte_ranges_compose",
        "summary": "Compose HTTP byte-range bodies",
        "description": "Compose exact inert single-range or multipart/byteranges 206 bodies, or an empty 416 artifact, from supplied nonempty Base64 bytes and a strict Range field. Byte-preserving order, offsets, fields and SHA-256; no conditional-request checks or transmission.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-byte-ranges-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compose multipart byteranges body",
            "build exact partial content response bytes",
            "serialize single range Content-Range payload"
          ],
          "whenToUse": [
            "Create bounded partial-content test artifacts from inline bytes without decoding or contacting a server"
          ],
          "whenNotToUse": [
            "No remote fetching, request transmission, filesystem access, caching, content decoding or authenticity verification",
            "No server policy, method, conditional request or If-Range enforcement; callers must check applicability separately",
            "Not a full HTTP parser: unsupported units, empty list members, inner whitespace and numbers over 20 digits are rejected by this bounded profile",
            "Empty representations, media-type parameters, automatic boundary generation or boundary tokens appearing anywhere in selected payloads"
          ],
          "capabilities": [
            "Resolves Range internally; no separately paid resolver call is required",
            "Exact canonical Base64 body and SHA-256 over binary bytes",
            "Single or multipart selection preserves all satisfiable occurrences without coalescing",
            "At most 8 supplied Range members; linear boundary-collision scanning and full sizing precede payment"
          ],
          "related": [
            "http-byte-ranges-resolve",
            "multipart-form-encode",
            "http-etag-evaluate"
          ],
          "limits": {
            "inputBytes": 16384,
            "outputBytes": 24576,
            "jsonNodes": 128,
            "depth": 4,
            "rangeBytes": 2048,
            "ranges": 8,
            "composeRanges": 8,
            "integerDigits": 20,
            "representationBytes": 8192,
            "bodyBytes": 8192,
            "mediaTypeBytes": 127,
            "boundaryBytes": 60,
            "profile": "http-byte-ranges-body-v1"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_UNICODE",
            "INVALID_RANGE",
            "INVALID_BASE64",
            "EMPTY_REPRESENTATION",
            "BOUNDARY_REQUIRED",
            "UNUSED_BOUNDARY",
            "BOUNDARY_COLLISION",
            "INPUT_LIMIT",
            "INTEGER_LIMIT",
            "RANGE_LIMIT",
            "COMPLEXITY_LIMIT",
            "OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "representationBase64": {
                    "type": "string",
                    "maxLength": 10924,
                    "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$(?![\\s\\S])"
                  },
                  "range": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2048,
                    "pattern": "^[\\x09\\x20-\\x7e]+$(?![\\s\\S])"
                  },
                  "mediaType": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 127,
                    "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+\\/[!#$%&'*+.^_`|~0-9A-Za-z-]+$(?![\\s\\S])"
                  },
                  "boundary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 60,
                    "pattern": "^[A-Za-z0-9_-]+$(?![\\s\\S])"
                  }
                },
                "required": [
                  "representationBase64",
                  "range",
                  "mediaType"
                ],
                "additionalProperties": false
              },
              "example": {
                "representationBase64": "MDEyMzQ1Njc4OQ==",
                "range": "bytes=0-1,-2",
                "mediaType": "application/octet-stream",
                "boundary": "asm-demo"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-byte-ranges-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-byte-ranges-body-v1"
                        },
                        "representationByteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 8192
                        },
                        "representationSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$(?![\\s\\S])"
                        },
                        "normalizedRange": {
                          "type": "string",
                          "maxLength": 2048
                        },
                        "disposition": {
                          "type": "string",
                          "enum": [
                            "single",
                            "multipart",
                            "unsatisfiable"
                          ]
                        },
                        "statusCode": {
                          "anyOf": [
                            {
                              "type": "number",
                              "const": 206
                            },
                            {
                              "type": "number",
                              "const": 416
                            }
                          ]
                        },
                        "headers": {
                          "minItems": 2,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "enum": [
                                  "content-type",
                                  "content-range",
                                  "content-length"
                                ]
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 256
                              }
                            },
                            "required": [
                              "name",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "bodyBase64": {
                          "type": "string",
                          "maxLength": 10924,
                          "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$(?![\\s\\S])"
                        },
                        "bodyByteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 8192
                        },
                        "bodySha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$(?![\\s\\S])"
                        },
                        "parts": {
                          "maxItems": 8,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "rangeIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 7
                              },
                              "sourceStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8192
                              },
                              "sourceEndExclusive": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8192
                              },
                              "contentRange": {
                                "type": "string",
                                "maxLength": 80
                              },
                              "headerStart": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 8192
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "bodyStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8192
                              },
                              "bodyEndExclusive": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8192
                              }
                            },
                            "required": [
                              "rangeIndex",
                              "sourceStart",
                              "sourceEndExclusive",
                              "contentRange",
                              "headerStart",
                              "bodyStart",
                              "bodyEndExclusive"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "unsatisfiedIndexes": {
                          "maxItems": 8,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 7
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "representationByteLength",
                        "representationSha256",
                        "normalizedRange",
                        "disposition",
                        "statusCode",
                        "headers",
                        "bodyBase64",
                        "bodyByteLength",
                        "bodySha256",
                        "parts",
                        "unsatisfiedIndexes"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-byte-ranges-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-byte-ranges-body-v1",
                    "representationByteLength": 10,
                    "representationSha256": "84d89877f0d4041efb6bf91a16f0248f2fd573e6af05c19f96bedb9f882f7882",
                    "normalizedRange": "bytes=0-1,-2",
                    "disposition": "multipart",
                    "statusCode": 206,
                    "headers": [
                      {
                        "name": "content-type",
                        "value": "multipart/byteranges; boundary=asm-demo"
                      },
                      {
                        "name": "content-length",
                        "value": "188"
                      }
                    ],
                    "bodyBase64": "LS1hc20tZGVtbw0KQ29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9vY3RldC1zdHJlYW0NCkNvbnRlbnQtUmFuZ2U6IGJ5dGVzIDAtMS8xMA0KDQowMQ0KLS1hc20tZGVtbw0KQ29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9vY3RldC1zdHJlYW0NCkNvbnRlbnQtUmFuZ2U6IGJ5dGVzIDgtOS8xMA0KDQo4OQ0KLS1hc20tZGVtby0tDQo=",
                    "bodyByteLength": 188,
                    "bodySha256": "8c00af0e0d042f38edfe820ff6f399dcab6d90ad91374fd25e639051eda0086a",
                    "parts": [
                      {
                        "rangeIndex": 0,
                        "sourceStart": 0,
                        "sourceEndExclusive": 2,
                        "contentRange": "bytes 0-1/10",
                        "headerStart": 0,
                        "bodyStart": 83,
                        "bodyEndExclusive": 85
                      },
                      {
                        "rangeIndex": 1,
                        "sourceStart": 8,
                        "sourceEndExclusive": 10,
                        "contentRange": "bytes 8-9/10",
                        "headerStart": 87,
                        "bodyStart": 170,
                        "bodyEndExclusive": 172
                      }
                    ],
                    "unsatisfiedIndexes": []
                  },
                  "provenance": {
                    "inputSha256": "4f0beb8da86b883826c74719cf6ad2da918d9beb0b5d2fd192f42c8a0bf448f9",
                    "outputSha256": "f7d4001ede91f24739c26320a912ad4afa297647361157d6eb32f5e2e7075864",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/route-matrix-optimize": {
      "post": {
        "operationId": "x402_route_matrix_optimize",
        "summary": "Exact supplied-matrix route",
        "description": "Find an exact minimum-cost directed route visiting every supplied stop once, as a fixed-start cycle or open path with optional fixed end. Null arcs are forbidden; no maps, geocoding, traffic, vehicle capacity, time windows or dispatch.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/route-matrix-optimize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Optimize a small directed travelling-salesperson tour from a supplied cost matrix",
            "Choose the least-cost order for visiting every supplied stop exactly once"
          ],
          "whenToUse": [
            "All leg costs and allowed arcs are supplied in one declared unit; at most 12 stops including the start"
          ],
          "whenNotToUse": [
            "Shortest paths that may skip/revisit stops, real routing data, multiple vehicles, capacity or time windows",
            "General route search beyond the exact bounded Hamiltonian model",
            "Investment advice, high-impact decisions about people, or validating the truth of caller assumptions"
          ],
          "capabilities": [
            "Exact decimal BigInt subset dynamic programming with lexical optimal ties",
            "Explicit cycle, free-end path or fixed-end path; valid infeasible results have no route",
            "A one-stop request produces its start only, no self-loop and exact zero cost",
            "Complete computation and result sizing before payment challenge",
            "Exact bounded supplied-data arithmetic; no network, clock, randomness or external action"
          ],
          "related": [
            "assignment-cost-optimize",
            "workflow-resource-plan"
          ],
          "limits": {
            "inputBytes": 48000,
            "outputBytes": 192000,
            "jsonNodes": 8000,
            "depth": 12,
            "stops": 12,
            "matrixCells": 144,
            "allocatedDpCells": 24576,
            "maximumTransitionChecks": 135168,
            "decimalIntegerDigits": 12,
            "decimalFractionDigits": 6
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "DUPLICATE_ID",
            "MATRIX_SHAPE",
            "UNKNOWN_STOP",
            "INVALID_ENDPOINTS",
            "INVALID_DIAGONAL",
            "INTERNAL_ROUTE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "stopIds": {
                    "minItems": 1,
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    }
                  },
                  "costs": {
                    "minItems": 1,
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 12,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    }
                  },
                  "route": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "cycle"
                          },
                          "startId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          }
                        },
                        "required": [
                          "kind",
                          "startId"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "path"
                          },
                          "startId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          },
                          "endId": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        },
                        "required": [
                          "kind",
                          "startId",
                          "endId"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "costUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  }
                },
                "required": [
                  "stopIds",
                  "costs",
                  "route",
                  "costUnit"
                ],
                "additionalProperties": false
              },
              "example": {
                "stopIds": [
                  "depot",
                  "alpha",
                  "beta",
                  "gamma"
                ],
                "costs": [
                  [
                    "0",
                    "4",
                    "2",
                    "8"
                  ],
                  [
                    "3",
                    "0",
                    "5",
                    "2"
                  ],
                  [
                    "7",
                    "1",
                    "0",
                    "6"
                  ],
                  [
                    "3",
                    "4",
                    "2",
                    "0"
                  ]
                ],
                "route": {
                  "kind": "cycle",
                  "startId": "depot"
                },
                "costUnit": "declared travel minutes"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "route-matrix-optimize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "exact-directed-hamiltonian-route-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "assumptionsVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "costUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "stopIds": {
                              "minItems": 1,
                              "maxItems": 12,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              }
                            },
                            "route": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "cycle"
                                    },
                                    "startId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 64
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "startId"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "path"
                                    },
                                    "startId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 64
                                    },
                                    "endId": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 64
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "startId",
                                    "endId"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            "algorithm": {
                              "type": "string",
                              "const": "subset-dynamic-programming"
                            },
                            "work": {
                              "type": "object",
                              "properties": {
                                "statesEvaluated": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 24576
                                },
                                "transitionsConsidered": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 135168
                                }
                              },
                              "required": [
                                "statesEvaluated",
                                "transitionsConsidered"
                              ],
                              "additionalProperties": false
                            },
                            "status": {
                              "type": "string",
                              "const": "optimal"
                            },
                            "visitOrder": {
                              "minItems": 1,
                              "maxItems": 13,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              }
                            },
                            "legs": {
                              "maxItems": 12,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "fromId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 64
                                  },
                                  "toId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 64
                                  },
                                  "cost": {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "pattern": "^(?:0|[1-9][0-9]*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "pattern": "^[1-9][0-9]*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "required": [
                                  "fromId",
                                  "toId",
                                  "cost"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "totalCost": {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "pattern": "^[1-9][0-9]*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            "tieBreak": {
                              "type": "string",
                              "const": "lexicographically-smallest-visit-order-by-UTF-16"
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "assumptionsVerified",
                            "costUnit",
                            "stopIds",
                            "route",
                            "algorithm",
                            "work",
                            "status",
                            "visitOrder",
                            "legs",
                            "totalCost",
                            "tieBreak"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "exact-directed-hamiltonian-route-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "assumptionsVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "costUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "stopIds": {
                              "minItems": 1,
                              "maxItems": 12,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              }
                            },
                            "route": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "cycle"
                                    },
                                    "startId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 64
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "startId"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "path"
                                    },
                                    "startId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 64
                                    },
                                    "endId": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 64
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "startId",
                                    "endId"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            "algorithm": {
                              "type": "string",
                              "const": "subset-dynamic-programming"
                            },
                            "work": {
                              "type": "object",
                              "properties": {
                                "statesEvaluated": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 24576
                                },
                                "transitionsConsidered": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 135168
                                }
                              },
                              "required": [
                                "statesEvaluated",
                                "transitionsConsidered"
                              ],
                              "additionalProperties": false
                            },
                            "status": {
                              "type": "string",
                              "const": "infeasible"
                            },
                            "visitOrder": {
                              "type": "null"
                            },
                            "legs": {
                              "type": "null"
                            },
                            "totalCost": {
                              "type": "null"
                            },
                            "reason": {
                              "type": "string",
                              "const": "No route visits every supplied stop exactly once under the declared endpoints and allowed arcs"
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "assumptionsVerified",
                            "costUnit",
                            "stopIds",
                            "route",
                            "algorithm",
                            "work",
                            "status",
                            "visitOrder",
                            "legs",
                            "totalCost",
                            "reason"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "route-matrix-optimize",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-directed-hamiltonian-route-v1",
                    "externalRequests": 0,
                    "execution": false,
                    "assumptionsVerified": false,
                    "costUnit": "declared travel minutes",
                    "stopIds": [
                      "alpha",
                      "beta",
                      "depot",
                      "gamma"
                    ],
                    "route": {
                      "kind": "cycle",
                      "startId": "depot"
                    },
                    "algorithm": "subset-dynamic-programming",
                    "work": {
                      "statesEvaluated": 20,
                      "transitionsConsidered": 24
                    },
                    "status": "optimal",
                    "visitOrder": [
                      "depot",
                      "beta",
                      "alpha",
                      "gamma",
                      "depot"
                    ],
                    "legs": [
                      {
                        "fromId": "depot",
                        "toId": "beta",
                        "cost": {
                          "numerator": "2",
                          "denominator": "1"
                        }
                      },
                      {
                        "fromId": "beta",
                        "toId": "alpha",
                        "cost": {
                          "numerator": "1",
                          "denominator": "1"
                        }
                      },
                      {
                        "fromId": "alpha",
                        "toId": "gamma",
                        "cost": {
                          "numerator": "2",
                          "denominator": "1"
                        }
                      },
                      {
                        "fromId": "gamma",
                        "toId": "depot",
                        "cost": {
                          "numerator": "3",
                          "denominator": "1"
                        }
                      }
                    ],
                    "totalCost": {
                      "numerator": "8",
                      "denominator": "1"
                    },
                    "tieBreak": "lexicographically-smallest-visit-order-by-UTF-16"
                  },
                  "provenance": {
                    "inputSha256": "69efa70491b7b083786ef5f6071ee2963cb1eaaf0be6d0d27dec7bc05b2648d2",
                    "outputSha256": "49ae8abe2fd859ad0e439a60afe82b5b38520337afe6da77ca7d9d5e80942e9d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.010",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/decision-scenarios-analyze": {
      "post": {
        "operationId": "x402_decision_scenarios_analyze",
        "summary": "Exact finite-scenario decision tradeoffs",
        "description": "Compare caller-defined alternatives using a complete loss matrix: all expected-loss, worst-loss and minimax-regret optima, scenario Pareto dominance and perfect-information value. Optional explicit positive relative probabilities; no inferred likelihoods or universal recommendation.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/decision-scenarios-analyze.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compare decision alternatives under supplied uncertain scenarios",
            "Compute exact minimax regret, worst-case loss and Pareto-dominated options",
            "Calculate expected-loss choices and perfect-information value from explicit scenario weights"
          ],
          "whenToUse": [
            "Caller supplies complete nonnegative losses in one unit for every alternative and scenario",
            "Use null probabilityWeights when no probability model is justified"
          ],
          "whenNotToUse": [
            "Forecasting, eliciting utilities or probabilities, validating scenario completeness, continuous or randomized policies",
            "Weighted rubric aggregation with missing observations or incompatible units",
            "Investment advice, high-impact decisions about people, or validating the truth of caller assumptions"
          ],
          "capabilities": [
            "All tied minimizers retained with exact decimal and rational arithmetic",
            "Strict Pareto dominance requires no worse loss everywhere and strictly lower loss somewhere; identical alternatives remain nondominated",
            "Expected values are absent unless strictly positive relative probability weights are supplied for every scenario",
            "Perfect-information value assumes cost-free advance revelation of the supplied scenario and is not the value of a real experiment",
            "Exact bounded supplied-data arithmetic; no network, clock, randomness or external action"
          ],
          "related": [
            "rubric-score-aggregate",
            "inventory-scenarios-optimize"
          ],
          "limits": {
            "inputBytes": 48000,
            "outputBytes": 192000,
            "jsonNodes": 8000,
            "depth": 12,
            "alternatives": 24,
            "scenarios": 24,
            "matrixCells": 576,
            "maximumDominanceCellComparisons": 27648,
            "decimalIntegerDigits": 12,
            "decimalFractionDigits": 6,
            "probabilityWeightDigits": 9
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "DUPLICATE_ID",
            "MATRIX_SHAPE",
            "WEIGHT_SHAPE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "alternativeIds": {
                    "minItems": 1,
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    }
                  },
                  "scenarioIds": {
                    "minItems": 1,
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    }
                  },
                  "losses": {
                    "minItems": 1,
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 24,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                      }
                    }
                  },
                  "probabilityWeights": {
                    "anyOf": [
                      {
                        "minItems": 1,
                        "maxItems": 24,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "pattern": "^[1-9][0-9]{0,8}$"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "lossUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  }
                },
                "required": [
                  "alternativeIds",
                  "scenarioIds",
                  "losses",
                  "probabilityWeights",
                  "lossUnit"
                ],
                "additionalProperties": false
              },
              "example": {
                "alternativeIds": [
                  "small-cache",
                  "balanced-cache",
                  "large-cache"
                ],
                "scenarioIds": [
                  "light-load",
                  "heavy-load"
                ],
                "losses": [
                  [
                    "2",
                    "12"
                  ],
                  [
                    "5",
                    "6"
                  ],
                  [
                    "9",
                    "3"
                  ]
                ],
                "probabilityWeights": [
                  "3",
                  "1"
                ],
                "lossUnit": "caller-defined operating loss units"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "decision-scenarios-analyze",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "finite-scenario-loss-analysis-v1"
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "assumptionsVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "lossUnit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "scenarioIds": {
                          "minItems": 1,
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          }
                        },
                        "probabilityModel": {
                          "type": "string",
                          "enum": [
                            "none-supplied",
                            "normalized-positive-relative-weights"
                          ]
                        },
                        "scenarios": {
                          "minItems": 1,
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "scenarioId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              "probability": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "pattern": "^(?:0|[1-9][0-9]*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "pattern": "^[1-9][0-9]*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "bestLoss": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "bestAlternativeIds": {
                                "minItems": 1,
                                "maxItems": 24,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                }
                              }
                            },
                            "required": [
                              "scenarioId",
                              "probability",
                              "bestLoss",
                              "bestAlternativeIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "alternatives": {
                          "minItems": 1,
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "alternativeId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              "expectedLoss": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "pattern": "^(?:0|[1-9][0-9]*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "pattern": "^[1-9][0-9]*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "worstLoss": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "maximumRegret": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "regrets": {
                                "minItems": 1,
                                "maxItems": 24,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "numerator": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "denominator": {
                                      "type": "string",
                                      "pattern": "^[1-9][0-9]*$"
                                    }
                                  },
                                  "required": [
                                    "numerator",
                                    "denominator"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "dominatedBy": {
                                "maxItems": 23,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                }
                              }
                            },
                            "required": [
                              "alternativeId",
                              "expectedLoss",
                              "worstLoss",
                              "maximumRegret",
                              "regrets",
                              "dominatedBy"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "criteria": {
                          "type": "object",
                          "properties": {
                            "expectedLoss": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "minimum": {
                                      "type": "object",
                                      "properties": {
                                        "numerator": {
                                          "type": "string",
                                          "pattern": "^(?:0|[1-9][0-9]*)$"
                                        },
                                        "denominator": {
                                          "type": "string",
                                          "pattern": "^[1-9][0-9]*$"
                                        }
                                      },
                                      "required": [
                                        "numerator",
                                        "denominator"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "alternativeIds": {
                                      "minItems": 1,
                                      "maxItems": 24,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 64
                                      }
                                    }
                                  },
                                  "required": [
                                    "minimum",
                                    "alternativeIds"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "worstLoss": {
                              "type": "object",
                              "properties": {
                                "minimum": {
                                  "type": "object",
                                  "properties": {
                                    "numerator": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "denominator": {
                                      "type": "string",
                                      "pattern": "^[1-9][0-9]*$"
                                    }
                                  },
                                  "required": [
                                    "numerator",
                                    "denominator"
                                  ],
                                  "additionalProperties": false
                                },
                                "alternativeIds": {
                                  "minItems": 1,
                                  "maxItems": 24,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 64
                                  }
                                }
                              },
                              "required": [
                                "minimum",
                                "alternativeIds"
                              ],
                              "additionalProperties": false
                            },
                            "maximumRegret": {
                              "type": "object",
                              "properties": {
                                "minimum": {
                                  "type": "object",
                                  "properties": {
                                    "numerator": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "denominator": {
                                      "type": "string",
                                      "pattern": "^[1-9][0-9]*$"
                                    }
                                  },
                                  "required": [
                                    "numerator",
                                    "denominator"
                                  ],
                                  "additionalProperties": false
                                },
                                "alternativeIds": {
                                  "minItems": 1,
                                  "maxItems": 24,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 64
                                  }
                                }
                              },
                              "required": [
                                "minimum",
                                "alternativeIds"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "expectedLoss",
                            "worstLoss",
                            "maximumRegret"
                          ],
                          "additionalProperties": false
                        },
                        "paretoAlternativeIds": {
                          "minItems": 1,
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          }
                        },
                        "perfectInformation": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "expectedBestScenarioLoss": {
                                  "type": "object",
                                  "properties": {
                                    "numerator": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "denominator": {
                                      "type": "string",
                                      "pattern": "^[1-9][0-9]*$"
                                    }
                                  },
                                  "required": [
                                    "numerator",
                                    "denominator"
                                  ],
                                  "additionalProperties": false
                                },
                                "expectedValue": {
                                  "type": "object",
                                  "properties": {
                                    "numerator": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "denominator": {
                                      "type": "string",
                                      "pattern": "^[1-9][0-9]*$"
                                    }
                                  },
                                  "required": [
                                    "numerator",
                                    "denominator"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "required": [
                                "expectedBestScenarioLoss",
                                "expectedValue"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "tiePolicy": {
                          "type": "string",
                          "const": "return-all-exact-ties-in-UTF-16-ID-order"
                        }
                      },
                      "required": [
                        "profile",
                        "externalRequests",
                        "execution",
                        "assumptionsVerified",
                        "lossUnit",
                        "scenarioIds",
                        "probabilityModel",
                        "scenarios",
                        "alternatives",
                        "criteria",
                        "paretoAlternativeIds",
                        "perfectInformation",
                        "tiePolicy"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "decision-scenarios-analyze",
                  "version": "0.29.0",
                  "result": {
                    "profile": "finite-scenario-loss-analysis-v1",
                    "externalRequests": 0,
                    "execution": false,
                    "assumptionsVerified": false,
                    "lossUnit": "caller-defined operating loss units",
                    "scenarioIds": [
                      "heavy-load",
                      "light-load"
                    ],
                    "probabilityModel": "normalized-positive-relative-weights",
                    "scenarios": [
                      {
                        "scenarioId": "heavy-load",
                        "probability": {
                          "numerator": "1",
                          "denominator": "4"
                        },
                        "bestLoss": {
                          "numerator": "3",
                          "denominator": "1"
                        },
                        "bestAlternativeIds": [
                          "large-cache"
                        ]
                      },
                      {
                        "scenarioId": "light-load",
                        "probability": {
                          "numerator": "3",
                          "denominator": "4"
                        },
                        "bestLoss": {
                          "numerator": "2",
                          "denominator": "1"
                        },
                        "bestAlternativeIds": [
                          "small-cache"
                        ]
                      }
                    ],
                    "alternatives": [
                      {
                        "alternativeId": "balanced-cache",
                        "expectedLoss": {
                          "numerator": "21",
                          "denominator": "4"
                        },
                        "worstLoss": {
                          "numerator": "6",
                          "denominator": "1"
                        },
                        "maximumRegret": {
                          "numerator": "3",
                          "denominator": "1"
                        },
                        "regrets": [
                          {
                            "numerator": "3",
                            "denominator": "1"
                          },
                          {
                            "numerator": "3",
                            "denominator": "1"
                          }
                        ],
                        "dominatedBy": []
                      },
                      {
                        "alternativeId": "large-cache",
                        "expectedLoss": {
                          "numerator": "15",
                          "denominator": "2"
                        },
                        "worstLoss": {
                          "numerator": "9",
                          "denominator": "1"
                        },
                        "maximumRegret": {
                          "numerator": "7",
                          "denominator": "1"
                        },
                        "regrets": [
                          {
                            "numerator": "0",
                            "denominator": "1"
                          },
                          {
                            "numerator": "7",
                            "denominator": "1"
                          }
                        ],
                        "dominatedBy": []
                      },
                      {
                        "alternativeId": "small-cache",
                        "expectedLoss": {
                          "numerator": "9",
                          "denominator": "2"
                        },
                        "worstLoss": {
                          "numerator": "12",
                          "denominator": "1"
                        },
                        "maximumRegret": {
                          "numerator": "9",
                          "denominator": "1"
                        },
                        "regrets": [
                          {
                            "numerator": "9",
                            "denominator": "1"
                          },
                          {
                            "numerator": "0",
                            "denominator": "1"
                          }
                        ],
                        "dominatedBy": []
                      }
                    ],
                    "criteria": {
                      "expectedLoss": {
                        "minimum": {
                          "numerator": "9",
                          "denominator": "2"
                        },
                        "alternativeIds": [
                          "small-cache"
                        ]
                      },
                      "worstLoss": {
                        "minimum": {
                          "numerator": "6",
                          "denominator": "1"
                        },
                        "alternativeIds": [
                          "balanced-cache"
                        ]
                      },
                      "maximumRegret": {
                        "minimum": {
                          "numerator": "3",
                          "denominator": "1"
                        },
                        "alternativeIds": [
                          "balanced-cache"
                        ]
                      }
                    },
                    "paretoAlternativeIds": [
                      "balanced-cache",
                      "large-cache",
                      "small-cache"
                    ],
                    "perfectInformation": {
                      "expectedBestScenarioLoss": {
                        "numerator": "9",
                        "denominator": "4"
                      },
                      "expectedValue": {
                        "numerator": "9",
                        "denominator": "4"
                      }
                    },
                    "tiePolicy": "return-all-exact-ties-in-UTF-16-ID-order"
                  },
                  "provenance": {
                    "inputSha256": "6503438bf50595b06913f93b1bcf8848af7f8a5603bdaba4569da2df1f5e00e1",
                    "outputSha256": "7da7e3fd918490552b1a161ace8b7bc4f28243452db8962ae66114ab202853cb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/x402/inventory-scenarios-optimize": {
      "post": {
        "operationId": "x402_inventory_scenarios_optimize",
        "summary": "Exact finite-scenario inventory order",
        "description": "Enumerate every admissible one-period order quantity and minimize exact expected purchase, fixed-order, leftover and unmet-demand costs under caller-supplied demand scenarios. Return all optimal quantities and scenario arithmetic; no demand forecast, service guarantee or order placement.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/inventory-scenarios-optimize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Optimize a single-period reorder quantity under explicit demand scenarios",
            "Compare order multiples and minimum-positive-order constraints with holding and shortage costs"
          ],
          "whenToUse": [
            "Supply integer inventory and demand in one unit, positive relative scenario probabilities and nonnegative cost assumptions",
            "All replenishment arrives before demand and every positive order follows the declared multiple and minimum"
          ],
          "whenNotToUse": [
            "Forecasting, multi-period inventory, uncertain lead time, backorder carryover, shelf life, multiple products or capacity coupling",
            "Real procurement, inventory availability checks, service-level promises or profit optimization",
            "Investment advice, high-impact decisions about people, or validating the truth of caller assumptions"
          ],
          "capabilities": [
            "Exact exhaustive expected-cost optimum across at most 512 legal quantities; zero order is always permitted",
            "Complete candidate expected/worst cost table, all exact ties, and smallest-quantity tie break",
            "Chosen-scenario shortage, leftover and normalized probabilities; existing on-hand purchase cost is sunk and excluded",
            "Stockout probability applies only to the supplied finite scenario model and is not a calibrated real-world risk estimate",
            "Exact bounded supplied-data arithmetic; no network, clock, randomness or external action"
          ],
          "related": [
            "decision-scenarios-analyze",
            "decimal-distribution-summarize"
          ],
          "limits": {
            "inputBytes": 48000,
            "outputBytes": 192000,
            "jsonNodes": 8000,
            "depth": 12,
            "scenarios": 32,
            "orderCandidates": 512,
            "maximumCandidateScenarioEvaluations": 16384,
            "maximumChosenScenarioEvaluations": 32,
            "quantityMaximum": 1000000,
            "decimalIntegerDigits": 12,
            "decimalFractionDigits": 6,
            "probabilityWeightDigits": 9
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "DUPLICATE_ID",
            "CANDIDATE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "onHand": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "scenarios": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "demand": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000
                        },
                        "probabilityWeight": {
                          "type": "string",
                          "pattern": "^[1-9][0-9]{0,8}$"
                        }
                      },
                      "required": [
                        "id",
                        "demand",
                        "probabilityWeight"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "order": {
                    "type": "object",
                    "properties": {
                      "minimumPositive": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      },
                      "maximum": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000
                      },
                      "multiple": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      }
                    },
                    "required": [
                      "minimumPositive",
                      "maximum",
                      "multiple"
                    ],
                    "additionalProperties": false
                  },
                  "costs": {
                    "type": "object",
                    "properties": {
                      "purchasePerUnit": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                      },
                      "holdingPerUnit": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                      },
                      "shortagePerUnit": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                      },
                      "fixedPositiveOrder": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                      }
                    },
                    "required": [
                      "purchasePerUnit",
                      "holdingPerUnit",
                      "shortagePerUnit",
                      "fixedPositiveOrder"
                    ],
                    "additionalProperties": false
                  },
                  "quantityUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "costUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  }
                },
                "required": [
                  "onHand",
                  "scenarios",
                  "order",
                  "costs",
                  "quantityUnit",
                  "costUnit"
                ],
                "additionalProperties": false
              },
              "example": {
                "onHand": 3,
                "scenarios": [
                  {
                    "id": "low",
                    "demand": 4,
                    "probabilityWeight": "1"
                  },
                  {
                    "id": "normal",
                    "demand": 8,
                    "probabilityWeight": "2"
                  },
                  {
                    "id": "high",
                    "demand": 12,
                    "probabilityWeight": "1"
                  }
                ],
                "order": {
                  "minimumPositive": 4,
                  "maximum": 12,
                  "multiple": 2
                },
                "costs": {
                  "purchasePerUnit": "2",
                  "holdingPerUnit": "1",
                  "shortagePerUnit": "7",
                  "fixedPositiveOrder": "3"
                },
                "quantityUnit": "units",
                "costUnit": "caller-defined cost units"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "inventory-scenarios-optimize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "finite-scenario-single-period-inventory-v1"
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "assumptionsVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "const": "optimal"
                        },
                        "quantityUnit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "costUnit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "orderQuantity": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000
                        },
                        "availableQuantity": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2000000
                        },
                        "expectedCost": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "pattern": "^[1-9][0-9]*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "worstCost": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "pattern": "^[1-9][0-9]*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "expectedShortage": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "pattern": "^[1-9][0-9]*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "expectedLeftover": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "pattern": "^[1-9][0-9]*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "suppliedScenarioStockoutProbability": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "pattern": "^[1-9][0-9]*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "optimalOrderQuantities": {
                          "minItems": 1,
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 1000000
                          }
                        },
                        "candidates": {
                          "minItems": 1,
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "orderQuantity": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              },
                              "expectedCost": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "worstCost": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "orderQuantity",
                              "expectedCost",
                              "worstCost"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "chosenScenarios": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "scenarioId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              "probability": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "demand": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              },
                              "shortage": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              },
                              "leftover": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 2000000
                              },
                              "cost": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "scenarioId",
                              "probability",
                              "demand",
                              "shortage",
                              "leftover",
                              "cost"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "model": {
                          "type": "object",
                          "properties": {
                            "period": {
                              "type": "string",
                              "const": "single-period"
                            },
                            "replenishment": {
                              "type": "string",
                              "const": "all-ordered-units-before-demand"
                            },
                            "unmetDemand": {
                              "type": "string",
                              "const": "penalized-without-carryover"
                            },
                            "demandSource": {
                              "type": "string",
                              "const": "caller-supplied-finite-scenarios"
                            },
                            "probabilityModel": {
                              "type": "string",
                              "const": "normalized-positive-relative-weights"
                            }
                          },
                          "required": [
                            "period",
                            "replenishment",
                            "unmetDemand",
                            "demandSource",
                            "probabilityModel"
                          ],
                          "additionalProperties": false
                        },
                        "tieBreak": {
                          "type": "string",
                          "const": "smallest-order-quantity; all-optimal-quantities-also-returned"
                        }
                      },
                      "required": [
                        "profile",
                        "externalRequests",
                        "execution",
                        "assumptionsVerified",
                        "status",
                        "quantityUnit",
                        "costUnit",
                        "orderQuantity",
                        "availableQuantity",
                        "expectedCost",
                        "worstCost",
                        "expectedShortage",
                        "expectedLeftover",
                        "suppliedScenarioStockoutProbability",
                        "optimalOrderQuantities",
                        "candidates",
                        "chosenScenarios",
                        "model",
                        "tieBreak"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "inventory-scenarios-optimize",
                  "version": "0.29.0",
                  "result": {
                    "profile": "finite-scenario-single-period-inventory-v1",
                    "externalRequests": 0,
                    "execution": false,
                    "assumptionsVerified": false,
                    "status": "optimal",
                    "quantityUnit": "units",
                    "costUnit": "caller-defined cost units",
                    "orderQuantity": 6,
                    "availableQuantity": 9,
                    "expectedCost": {
                      "numerator": "22",
                      "denominator": "1"
                    },
                    "worstCost": {
                      "numerator": "36",
                      "denominator": "1"
                    },
                    "expectedShortage": {
                      "numerator": "3",
                      "denominator": "4"
                    },
                    "expectedLeftover": {
                      "numerator": "7",
                      "denominator": "4"
                    },
                    "suppliedScenarioStockoutProbability": {
                      "numerator": "1",
                      "denominator": "4"
                    },
                    "optimalOrderQuantities": [
                      6
                    ],
                    "candidates": [
                      {
                        "orderQuantity": 0,
                        "expectedCost": {
                          "numerator": "35",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "63",
                          "denominator": "1"
                        }
                      },
                      {
                        "orderQuantity": 4,
                        "expectedCost": {
                          "numerator": "24",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "46",
                          "denominator": "1"
                        }
                      },
                      {
                        "orderQuantity": 6,
                        "expectedCost": {
                          "numerator": "22",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "36",
                          "denominator": "1"
                        }
                      },
                      {
                        "orderQuantity": 8,
                        "expectedCost": {
                          "numerator": "24",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "26",
                          "denominator": "1"
                        }
                      },
                      {
                        "orderQuantity": 10,
                        "expectedCost": {
                          "numerator": "28",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "32",
                          "denominator": "1"
                        }
                      },
                      {
                        "orderQuantity": 12,
                        "expectedCost": {
                          "numerator": "34",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "38",
                          "denominator": "1"
                        }
                      }
                    ],
                    "chosenScenarios": [
                      {
                        "scenarioId": "high",
                        "probability": {
                          "numerator": "1",
                          "denominator": "4"
                        },
                        "demand": 12,
                        "shortage": 3,
                        "leftover": 0,
                        "cost": {
                          "numerator": "36",
                          "denominator": "1"
                        }
                      },
                      {
                        "scenarioId": "low",
                        "probability": {
                          "numerator": "1",
                          "denominator": "4"
                        },
                        "demand": 4,
                        "shortage": 0,
                        "leftover": 5,
                        "cost": {
                          "numerator": "20",
                          "denominator": "1"
                        }
                      },
                      {
                        "scenarioId": "normal",
                        "probability": {
                          "numerator": "1",
                          "denominator": "2"
                        },
                        "demand": 8,
                        "shortage": 0,
                        "leftover": 1,
                        "cost": {
                          "numerator": "16",
                          "denominator": "1"
                        }
                      }
                    ],
                    "model": {
                      "period": "single-period",
                      "replenishment": "all-ordered-units-before-demand",
                      "unmetDemand": "penalized-without-carryover",
                      "demandSource": "caller-supplied-finite-scenarios",
                      "probabilityModel": "normalized-positive-relative-weights"
                    },
                    "tieBreak": "smallest-order-quantity; all-optimal-quantities-also-returned"
                  },
                  "provenance": {
                    "inputSha256": "e9bd47771b7ab5ca743bc425d2ff7a74a1233428d38fead34e0639f779c794c2",
                    "outputSha256": "11a18148d92b8f02fda0cf2acaf2441beb31688c28e80deaeceba054958ad0a5",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.008",
        "x-payment-status": "runtime-not-evaluated",
        "x-x402": {
          "version": 2,
          "scheme": "exact",
          "runtimeConfiguration": "not-evaluated"
        }
      }
    },
    "/v1/mpp/json-canonicalize": {
      "post": {
        "operationId": "mpp_json_canonicalize",
        "summary": "Deterministic JSON serialization",
        "description": "WHEN TO USE: Normalize JSON for cache keys or repeatable diffs. Recursively sorts object keys, preserves array order, and emits compact JSON plus UTF-8 byte length. Uses JavaScript numbers and JSON.stringify: integer-index keys serialize numerically before other sorted keys; large integers may already have lost precision. This is not RFC 8785 cryptographic canonicalization. Maximum 100,000 serialized characters, 1,000 entries per collection, depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-canonicalize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "stable JSON cache key",
            "normalize JSON key order"
          ],
          "whenToUse": [
            "Sort JSON object keys for reproducible serialization."
          ],
          "whenNotToUse": [
            "Cryptographic RFC 8785 canonicalization or lossless arbitrary-precision numbers."
          ],
          "capabilities": [
            "json-canonicalize",
            "stable JSON cache key",
            "normalize JSON key order"
          ],
          "related": [
            "content-digest",
            "lines-diff"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "value": {
                    "$ref": "#/paths/~1v1~1mpp~1json-canonicalize/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "value"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-canonicalize/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-canonicalize/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "value": {
                  "customer": "Ada",
                  "active": true,
                  "settings": {
                    "theme": "dark",
                    "locale": "en"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-canonicalize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "canonical": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "bytesUtf8": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "canonical",
                        "bytesUtf8"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-canonicalize",
                  "version": "0.29.0",
                  "result": {
                    "canonical": "{\"active\":true,\"customer\":\"Ada\",\"settings\":{\"locale\":\"en\",\"theme\":\"dark\"}}",
                    "bytesUtf8": 74
                  },
                  "provenance": {
                    "inputSha256": "55026756992759c1270a9bf20c3734d5bb5e83e17bc2b1ad8af8455ecdb88498",
                    "outputSha256": "503d0b2c39cea4d203d24a39423288afa4f9b906eab37f7f1a4fa7898e2a661b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-pointer": {
      "post": {
        "operationId": "mpp_json_pointer",
        "summary": "JSON Pointer resolution",
        "description": "WHEN TO USE: Extract one precisely addressed value from an API payload without a query language. Resolves RFC 6901 string pointers, including ~0 and ~1 escaping and the empty root pointer. Missing members, URI fragments, leading-zero array indexes, and reserved prototype-related keys are errors. Maximum document size 100,000 characters and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-pointer.md"
        },
        "x-agent-discovery": {
          "intents": [
            "extract nested JSON field by exact path",
            "pick one value from an object or array response",
            "resolve RFC 6901 pointer"
          ],
          "whenToUse": [
            "Read one value at an exact JSON Pointer."
          ],
          "whenNotToUse": [
            "JSONPath queries, wildcard selection, or remote API fetching."
          ],
          "capabilities": [
            "json-pointer",
            "extract nested JSON field by exact path",
            "pick one value from an object or array response",
            "resolve RFC 6901 pointer"
          ],
          "related": [
            "records-project",
            "json-flatten"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1mpp~1json-pointer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "pointer": {
                    "type": "string",
                    "maxLength": 2048,
                    "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                  }
                },
                "required": [
                  "document",
                  "pointer"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-pointer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-pointer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "orders": [
                    {
                      "id": "ord_17",
                      "total": 49.5
                    }
                  ]
                },
                "pointer": "/orders/0/id"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-pointer",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "pointer": {
                          "type": "string",
                          "maxLength": 2048,
                          "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                        },
                        "value": {
                          "$ref": "#/paths/~1v1~1mpp~1json-pointer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        }
                      },
                      "required": [
                        "pointer",
                        "value"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-pointer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-pointer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-pointer",
                  "version": "0.29.0",
                  "result": {
                    "pointer": "/orders/0/id",
                    "value": "ord_17"
                  },
                  "provenance": {
                    "inputSha256": "06368e36f2e4a16c20eb00da9e6ac1c047c4561c8533d474d596fabd182de609",
                    "outputSha256": "09f8ce26cf2105810f77b709eb56b426a313e435d40f609062e40e2b12ec5483",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-patch": {
      "post": {
        "operationId": "mpp_json_patch",
        "summary": "Atomic JSON Patch",
        "description": "WHEN TO USE: Apply a bounded update plan atomically before saving an API document. Implements RFC 6902 add, remove, replace, move, copy, and structural test on a private clone; stops on the first error. Strict operation schemas reject extra fields. Up to 100 operations; size, depth, and 1,000-item limits checked after each operation. Removing the root returns documentExists=false and document=null; adding the root restores it. Reserved prototype-related paths are rejected.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-patch.md"
        },
        "x-agent-discovery": {
          "intents": [
            "apply RFC 6902 patch",
            "ordered property changes with value assertions",
            "atomic JSON document update"
          ],
          "whenToUse": [
            "Apply an explicit add/remove/replace/move/copy/test plan to supplied JSON."
          ],
          "whenNotToUse": [
            "Generating a patch from prose or writing to a remote system."
          ],
          "capabilities": [
            "json-patch",
            "apply RFC 6902 patch",
            "ordered property changes with value assertions",
            "atomic JSON document update"
          ],
          "related": [
            "json-merge-patch",
            "json-schema-check"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1mpp~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "operations": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "add"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "value": {
                              "$ref": "#/paths/~1v1~1mpp~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          },
                          "required": [
                            "op",
                            "path",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "replace"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "value": {
                              "$ref": "#/paths/~1v1~1mpp~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          },
                          "required": [
                            "op",
                            "path",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "test"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "value": {
                              "$ref": "#/paths/~1v1~1mpp~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          },
                          "required": [
                            "op",
                            "path",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "remove"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            }
                          },
                          "required": [
                            "op",
                            "path"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "move"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "from": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            }
                          },
                          "required": [
                            "op",
                            "path",
                            "from"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "op": {
                              "type": "string",
                              "const": "copy"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "from": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            }
                          },
                          "required": [
                            "op",
                            "path",
                            "from"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "document",
                  "operations"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "status": "draft",
                  "tags": [
                    "new"
                  ]
                },
                "operations": [
                  {
                    "op": "test",
                    "path": "/status",
                    "value": "draft"
                  },
                  {
                    "op": "replace",
                    "path": "/status",
                    "value": "ready"
                  },
                  {
                    "op": "add",
                    "path": "/tags/-",
                    "value": "reviewed"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-patch",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "document": {
                          "$ref": "#/paths/~1v1~1mpp~1json-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        },
                        "documentExists": {
                          "type": "boolean"
                        },
                        "appliedOperations": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "document",
                        "documentExists",
                        "appliedOperations"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-patch",
                  "version": "0.29.0",
                  "result": {
                    "document": {
                      "status": "ready",
                      "tags": [
                        "new",
                        "reviewed"
                      ]
                    },
                    "documentExists": true,
                    "appliedOperations": 3
                  },
                  "provenance": {
                    "inputSha256": "86cdf2df89d9a45405b30cbcd8fa9bf56893fe5adecd2727fda0afc3088ac15c",
                    "outputSha256": "2b59e51b84b627f0de07f1356e62caeb7d5d6c813c9813add695503ea058a568",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-merge-patch": {
      "post": {
        "operationId": "mpp_json_merge_patch",
        "summary": "JSON Merge Patch",
        "description": "WHEN TO USE: Apply simple partial-object updates using RFC 7396. Object members recursively merge, null members delete, arrays replace wholesale, and non-object patches replace the entire target. The target is never mutated. Maximum 100,000 serialized characters, 1,000 entries per collection, depth 32; reserved prototype-related keys are rejected.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-merge-patch.md"
        },
        "x-agent-discovery": {
          "intents": [
            "partial JSON object update",
            "apply RFC 7396 merge patch"
          ],
          "whenToUse": [
            "Merge partial objects, with null deleting members and arrays replacing wholesale."
          ],
          "whenNotToUse": [
            "Element-wise array merging or preserving explicit null object members."
          ],
          "capabilities": [
            "json-merge-patch",
            "partial JSON object update",
            "apply RFC 7396 merge patch"
          ],
          "related": [
            "json-patch"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "target": {
                    "$ref": "#/paths/~1v1~1mpp~1json-merge-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "patch": {
                    "$ref": "#/paths/~1v1~1mpp~1json-merge-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "target",
                  "patch"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-merge-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-merge-patch/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "target": {
                  "name": "Ada",
                  "preferences": {
                    "theme": "light",
                    "language": "en"
                  },
                  "obsolete": true
                },
                "patch": {
                  "preferences": {
                    "theme": "dark"
                  },
                  "obsolete": null
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-merge-patch",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "document": {
                          "$ref": "#/paths/~1v1~1mpp~1json-merge-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        }
                      },
                      "required": [
                        "document"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-merge-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-merge-patch/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-merge-patch",
                  "version": "0.29.0",
                  "result": {
                    "document": {
                      "name": "Ada",
                      "preferences": {
                        "theme": "dark",
                        "language": "en"
                      }
                    }
                  },
                  "provenance": {
                    "inputSha256": "5e708cad77d8f9ada135e40e77b8b6a13770eb705090add5c6ea4979c50624da",
                    "outputSha256": "7b2fc4fbc15ed1600fdd36aa9e1082189347d9206aca39b296dc0835527e1b45",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-flatten": {
      "post": {
        "operationId": "mpp_json_flatten",
        "summary": "Lossless JSON flattening",
        "description": "WHEN TO USE: Index nested payloads by escaped JSON Pointer for forms or change inspection. Returns scalar leaves in values and every object/array type in containers, preserving empty containers and numeric object keys for lossless unflattening. The root is represented by the empty pointer. Maximum 1,000 total pointers, output 100,000 characters, and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-flatten.md"
        },
        "x-agent-discovery": {
          "intents": [
            "flatten nested JSON to escaped paths and leaf values",
            "index JSON leaves and containers"
          ],
          "whenToUse": [
            "Produce escaped paths while preserving empty objects and arrays."
          ],
          "whenNotToUse": [
            "Flattening to ambiguous dotted keys or exceeding 1000 pointers."
          ],
          "capabilities": [
            "json-flatten",
            "flatten nested JSON to escaped paths and leaf values",
            "index JSON leaves and containers"
          ],
          "related": [
            "json-unflatten",
            "json-pointer"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1mpp~1json-flatten/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "document"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-flatten/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-flatten/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "customer": {
                    "name": "Ada"
                  },
                  "tags": [
                    "priority"
                  ],
                  "metadata": {}
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-flatten",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "values": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "maxLength": 2048,
                            "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                          },
                          "additionalProperties": {
                            "type": [
                              "string",
                              "number",
                              "boolean",
                              "null"
                            ]
                          }
                        },
                        "containers": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "maxLength": 2048,
                            "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                          },
                          "additionalProperties": {
                            "type": "string",
                            "enum": [
                              "object",
                              "array"
                            ]
                          }
                        },
                        "pointerCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "values",
                        "containers",
                        "pointerCount"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-flatten",
                  "version": "0.29.0",
                  "result": {
                    "values": {
                      "/customer/name": "Ada",
                      "/tags/0": "priority"
                    },
                    "containers": {
                      "": "object",
                      "/customer": "object",
                      "/tags": "array",
                      "/metadata": "object"
                    },
                    "pointerCount": 6
                  },
                  "provenance": {
                    "inputSha256": "495fc5c3012962fff807a29755798a6c1817291653fce5ab95b3a0ed729456b5",
                    "outputSha256": "4279f9640f858c0dde980d284e7bd1b14b915e868cf678b5812888d05b60ad05",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-unflatten": {
      "post": {
        "operationId": "mpp_json_unflatten",
        "summary": "Lossless JSON reconstruction",
        "description": "WHEN TO USE: Rebuild JSON from json-flatten output without guessing whether numeric keys belong to arrays or objects. Supply scalar values and explicit container types, including the empty root pointer. Rejects leaf/container collisions, missing parents, sparse arrays, unsafe keys, and malformed pointers. Maximum 1,000 combined pointers, 100,000 characters, depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-unflatten.md"
        },
        "x-agent-discovery": {
          "intents": [
            "reconstruct nested JSON from leaf paths",
            "restore flattened JSON preserving empty arrays and objects"
          ],
          "whenToUse": [
            "Rebuild a document from explicit scalar leaves and container kinds."
          ],
          "whenNotToUse": [
            "Guessing missing parent types or accepting sparse arrays."
          ],
          "capabilities": [
            "json-unflatten",
            "reconstruct nested JSON from leaf paths",
            "restore flattened JSON preserving empty arrays and objects"
          ],
          "related": [
            "json-flatten"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "values": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "maxLength": 2048,
                      "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                    },
                    "additionalProperties": {
                      "type": [
                        "string",
                        "number",
                        "boolean",
                        "null"
                      ]
                    }
                  },
                  "containers": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "maxLength": 2048,
                      "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                    },
                    "additionalProperties": {
                      "type": "string",
                      "enum": [
                        "object",
                        "array"
                      ]
                    }
                  }
                },
                "required": [
                  "values",
                  "containers"
                ],
                "additionalProperties": false
              },
              "example": {
                "values": {
                  "/customer/name": "Ada",
                  "/tags/0": "priority"
                },
                "containers": {
                  "": "object",
                  "/customer": "object",
                  "/tags": "array",
                  "/metadata": "object"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-unflatten",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "document": {
                          "$ref": "#/paths/~1v1~1mpp~1json-unflatten/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        },
                        "pointerCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "document",
                        "pointerCount"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-unflatten/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-unflatten/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-unflatten",
                  "version": "0.29.0",
                  "result": {
                    "document": {
                      "customer": {
                        "name": "Ada"
                      },
                      "tags": [
                        "priority"
                      ],
                      "metadata": {}
                    },
                    "pointerCount": 6
                  },
                  "provenance": {
                    "inputSha256": "51d1c2ecc468fe2a5eba7e867dea2c7629b5a2164a259d319361e7e79d3cf0d6",
                    "outputSha256": "6be9d6ede6c4bc809b96f86e2f3c076cda6fff9e8bd9e98dc61cd4aa16fecc0f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/records-project": {
      "post": {
        "operationId": "mpp_records_project",
        "summary": "Record field projection",
        "description": "WHEN TO USE: Shape up to 1,000 records into a small downstream payload, selecting nested fields with JSON Pointers and assigning flat output names. Up to 100 unique output names; missing fields are omitted, set to null, or rejected according to onMissing (default error). Unsafe names are rejected. Maximum 100,000 serialized characters and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-project.md"
        },
        "x-agent-discovery": {
          "intents": [
            "select and rename fields from each row",
            "keep only chosen nested record properties",
            "reshape API records"
          ],
          "whenToUse": [
            "Select JSON Pointer fields from each record and rename them to flat output names."
          ],
          "whenNotToUse": [
            "Computed expressions, joins, or arbitrary query languages."
          ],
          "capabilities": [
            "records-project",
            "select and rename fields from each row",
            "keep only chosen nested record properties",
            "reshape API records"
          ],
          "related": [
            "records-filter",
            "csv-serialize"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1records-project/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "fields": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "from": {
                          "type": "string",
                          "maxLength": 2048,
                          "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                        },
                        "as": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256
                        }
                      },
                      "required": [
                        "from",
                        "as"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "onMissing": {
                    "default": "error",
                    "type": "string",
                    "enum": [
                      "error",
                      "omit",
                      "null"
                    ]
                  }
                },
                "required": [
                  "records",
                  "fields"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1records-project/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1records-project/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "id": "c1",
                    "profile": {
                      "name": "Ada"
                    },
                    "internal": "omit"
                  }
                ],
                "fields": [
                  {
                    "from": "/id",
                    "as": "customerId"
                  },
                  {
                    "from": "/profile/name",
                    "as": "name"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-project",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "records": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "$ref": "#/paths/~1v1~1mpp~1records-project/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            }
                          }
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "records",
                        "count"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1records-project/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1records-project/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-project",
                  "version": "0.29.0",
                  "result": {
                    "records": [
                      {
                        "customerId": "c1",
                        "name": "Ada"
                      }
                    ],
                    "count": 1
                  },
                  "provenance": {
                    "inputSha256": "f54239296a6b1d7b1df43cfe10b8bf920db595adf68d52fd99b00196202691e6",
                    "outputSha256": "51fece40e9e2c76141564e414db25d9d0b890474cfddbf97176681a58b5999b0",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/records-filter": {
      "post": {
        "operationId": "mpp_records_filter",
        "summary": "Structured record filtering",
        "description": "WHEN TO USE: Select up to 1,000 records using 1–20 structured predicates with left-to-right short-circuit all/any logic, without executing code. All pointer syntax is validated before filtering. eq/ne use structural JSON equality; gt/gte/lt/lte compare same-type numbers or code-unit strings; contains tests substrings or structural array membership; in tests membership in a supplied list. Missing fields match only exists=false, including for ne. Returns original zero-based indexes. Maximum 100,000 characters and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-filter.md"
        },
        "x-agent-discovery": {
          "intents": [
            "filter records by predicates",
            "keep rows whose values match conditions",
            "select rows where amount exceeds threshold or status equals a value"
          ],
          "whenToUse": [
            "Apply structured all/any predicates without code execution."
          ],
          "whenNotToUse": [
            "Regular expressions, SQL, or fuzzy matching."
          ],
          "capabilities": [
            "records-filter",
            "filter records by predicates",
            "keep rows whose values match conditions",
            "select rows where amount exceeds threshold or status equals a value"
          ],
          "related": [
            "records-project",
            "records-sort"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1records-filter/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "mode": {
                    "default": "all",
                    "type": "string",
                    "enum": [
                      "all",
                      "any"
                    ]
                  },
                  "predicates": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "op": {
                              "type": "string",
                              "enum": [
                                "eq",
                                "ne",
                                "contains"
                              ]
                            },
                            "value": {
                              "$ref": "#/paths/~1v1~1mpp~1records-filter/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          },
                          "required": [
                            "path",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "op": {
                              "type": "string",
                              "enum": [
                                "gt",
                                "gte",
                                "lt",
                                "lte"
                              ]
                            },
                            "value": {
                              "type": [
                                "string",
                                "number"
                              ]
                            }
                          },
                          "required": [
                            "path",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "op": {
                              "type": "string",
                              "const": "in"
                            },
                            "value": {
                              "maxItems": 100,
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1records-filter/post/requestBody/content/application~1json/schema/$defs/__schema0"
                              }
                            }
                          },
                          "required": [
                            "path",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            },
                            "op": {
                              "type": "string",
                              "const": "exists"
                            },
                            "value": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "path",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "records",
                  "predicates"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1records-filter/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1records-filter/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "sku": "A",
                    "stock": 12
                  },
                  {
                    "sku": "B",
                    "stock": 0
                  }
                ],
                "predicates": [
                  {
                    "path": "/stock",
                    "op": "gt",
                    "value": 0
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-filter",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "records": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "$ref": "#/paths/~1v1~1mpp~1records-filter/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            }
                          }
                        },
                        "indexes": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          }
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "records",
                        "indexes",
                        "count"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1records-filter/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1records-filter/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-filter",
                  "version": "0.29.0",
                  "result": {
                    "records": [
                      {
                        "sku": "A",
                        "stock": 12
                      }
                    ],
                    "indexes": [
                      0
                    ],
                    "count": 1
                  },
                  "provenance": {
                    "inputSha256": "6bbbee34c174f2434adc101913e2f3cdfa5fb686d20a165a6cbcb99d87bce52b",
                    "outputSha256": "72825d8085a06c7b895fa71e54c0aac20a228d159605daf9dd0df53f116f890b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/records-sort": {
      "post": {
        "operationId": "mpp_records_sort",
        "summary": "Stable multi-key record sorting",
        "description": "WHEN TO USE: Order up to 1,000 records reproducibly using 1–10 nested JSON Pointer keys. Null and missing values tie and follow each key’s nulls setting independently of direction. Remaining ascending type order is boolean, number, string, array, object; booleans use false before true, strings use UTF-16 code units, arrays/objects compare deterministic JSON text. Equal keys preserve input order. Returns original indexes. Maximum 100,000 characters and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-sort.md"
        },
        "x-agent-discovery": {
          "intents": [
            "sort records by multiple fields",
            "stable JSON row ordering"
          ],
          "whenToUse": [
            "Order records by bounded nested keys with explicit null ordering."
          ],
          "whenNotToUse": [
            "Locale-aware collation or external database sorting."
          ],
          "capabilities": [
            "records-sort",
            "sort records by multiple fields",
            "stable JSON row ordering"
          ],
          "related": [
            "records-filter",
            "records-aggregate"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1records-sort/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "keys": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "maxLength": 2048,
                          "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                        },
                        "direction": {
                          "default": "asc",
                          "type": "string",
                          "enum": [
                            "asc",
                            "desc"
                          ]
                        },
                        "nulls": {
                          "default": "last",
                          "type": "string",
                          "enum": [
                            "first",
                            "last"
                          ]
                        }
                      },
                      "required": [
                        "path"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "records",
                  "keys"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1records-sort/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1records-sort/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "team": "sales",
                    "score": 8
                  },
                  {
                    "team": "sales",
                    "score": 10
                  },
                  {
                    "team": "support",
                    "score": 9
                  }
                ],
                "keys": [
                  {
                    "path": "/team"
                  },
                  {
                    "path": "/score",
                    "direction": "desc"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-sort",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "records": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "$ref": "#/paths/~1v1~1mpp~1records-sort/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            }
                          }
                        },
                        "indexes": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          }
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "records",
                        "indexes",
                        "count"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1records-sort/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1records-sort/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-sort",
                  "version": "0.29.0",
                  "result": {
                    "records": [
                      {
                        "team": "sales",
                        "score": 10
                      },
                      {
                        "team": "sales",
                        "score": 8
                      },
                      {
                        "team": "support",
                        "score": 9
                      }
                    ],
                    "indexes": [
                      1,
                      0,
                      2
                    ],
                    "count": 3
                  },
                  "provenance": {
                    "inputSha256": "01b4f1978ec7ceca60d6e6696d86754d1c04b927f6b3a91ee2f8d03c4608a264",
                    "outputSha256": "34c945ba894ca0a225e9a6204478c8d26dc2e9a9ab6dd6653a46f16b52f645ab",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/records-aggregate": {
      "post": {
        "operationId": "mpp_records_aggregate",
        "summary": "Grouped record aggregates",
        "description": "WHEN TO USE: Summarize up to 1,000 records with count/sum/avg/min/max, grouped by up to 5 JSON Pointer fields. Up to 20 uniquely named metrics. Group order follows first occurrence; missing keys are distinguished from null through a parallel missing array. Numeric metrics ignore missing/null, reject other non-numbers and overflow; empty sum/count are 0 and empty avg/min/max are null. No groupBy returns one global group, even for empty input. Maximum 100,000 characters and depth 32.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-aggregate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "group records sum average count",
            "aggregate JSON metrics"
          ],
          "whenToUse": [
            "Calculate count/sum/avg/min/max over supplied bounded records."
          ],
          "whenNotToUse": [
            "Database queries, streaming analytics, or arbitrary formulas."
          ],
          "capabilities": [
            "records-aggregate",
            "group records sum average count",
            "aggregate JSON metrics"
          ],
          "related": [
            "records-filter",
            "records-project"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1records-aggregate/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "groupBy": {
                    "default": [],
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 2048,
                      "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                    }
                  },
                  "metrics": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "as": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256
                            },
                            "op": {
                              "type": "string",
                              "const": "count"
                            }
                          },
                          "required": [
                            "as",
                            "op"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "as": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256
                            },
                            "op": {
                              "type": "string",
                              "enum": [
                                "sum",
                                "avg",
                                "min",
                                "max"
                              ]
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 2048,
                              "description": "RFC 6901 JSON string pointer; empty string selects the root. URI fragments are not accepted."
                            }
                          },
                          "required": [
                            "as",
                            "op",
                            "path"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "records",
                  "metrics"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1records-aggregate/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1records-aggregate/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "region": "west",
                    "revenue": 50
                  },
                  {
                    "region": "west",
                    "revenue": 70
                  },
                  {
                    "region": "east",
                    "revenue": 40
                  }
                ],
                "groupBy": [
                  "/region"
                ],
                "metrics": [
                  {
                    "as": "orders",
                    "op": "count"
                  },
                  {
                    "as": "revenue",
                    "op": "sum",
                    "path": "/revenue"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-aggregate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "groups": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "maxItems": 5,
                                "type": "array",
                                "items": {
                                  "$ref": "#/paths/~1v1~1mpp~1records-aggregate/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                }
                              },
                              "missing": {
                                "maxItems": 5,
                                "type": "array",
                                "items": {
                                  "type": "boolean"
                                }
                              },
                              "count": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "metrics": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string"
                                },
                                "additionalProperties": {
                                  "type": [
                                    "number",
                                    "null"
                                  ]
                                }
                              }
                            },
                            "required": [
                              "key",
                              "missing",
                              "count",
                              "metrics"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "groupCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "recordCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "groups",
                        "groupCount",
                        "recordCount"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1records-aggregate/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1records-aggregate/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-aggregate",
                  "version": "0.29.0",
                  "result": {
                    "groups": [
                      {
                        "key": [
                          "west"
                        ],
                        "missing": [
                          false
                        ],
                        "count": 2,
                        "metrics": {
                          "orders": 2,
                          "revenue": 120
                        }
                      },
                      {
                        "key": [
                          "east"
                        ],
                        "missing": [
                          false
                        ],
                        "count": 1,
                        "metrics": {
                          "orders": 1,
                          "revenue": 40
                        }
                      }
                    ],
                    "groupCount": 2,
                    "recordCount": 3
                  },
                  "provenance": {
                    "inputSha256": "1924642abbb9dfc99b456bc9f2aa018f71096fa07cd1d5289e23237e3ca70b97",
                    "outputSha256": "092e95776a8a0b1c38162cc0100533a2e195b8d90f706500a5865e45ed0a24eb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/csv-parse": {
      "post": {
        "operationId": "mpp_csv_parse",
        "summary": "Strict quoted CSV parser",
        "description": "WHEN TO USE: Convert a CSV export into string rows and optional header-keyed records. Handles RFC 4180 quoting, doubled quotes, embedded newlines, and CRLF; also accepts LF/CR line endings, one leading BOM, and optional semicolon/tab/pipe delimiters. Header mode defaults true and requires unique, nonempty, safe headers. Ragged rows and malformed quoting are errors. Values remain strings. Blank lines are one empty field; a final newline adds no row. Maximum 100,000 characters, 1,000 data rows, 100 columns.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/csv-parse.md"
        },
        "x-agent-discovery": {
          "intents": [
            "parse quoted CSV cells into JSON",
            "read comma delimited spreadsheet export with embedded newlines"
          ],
          "whenToUse": [
            "Parse bounded delimited text with strict quoting and rectangular rows."
          ],
          "whenNotToUse": [
            "Excel binary files, guessed value types, or malformed CSV repair."
          ],
          "capabilities": [
            "csv-parse",
            "parse quoted CSV cells into JSON",
            "read comma delimited spreadsheet export with embedded newlines"
          ],
          "related": [
            "csv-serialize",
            "records-project"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "delimiter": {
                    "default": ",",
                    "type": "string",
                    "enum": [
                      ",",
                      ";",
                      "\t",
                      "|"
                    ]
                  },
                  "header": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "name,city,note\r\nAda,London,\"likes tea, coffee\"\r\nLin,Taipei,\"said \"\"hello\"\"\"\r\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "csv-parse",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "headers": {
                          "anyOf": [
                            {
                              "maxItems": 100,
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "rows": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "maxItems": 100,
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "records": {
                          "anyOf": [
                            {
                              "maxItems": 1000,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string"
                                },
                                "additionalProperties": {
                                  "type": "string"
                                }
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "rowCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "columnCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "headers",
                        "rows",
                        "records",
                        "rowCount",
                        "columnCount"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "csv-parse",
                  "version": "0.29.0",
                  "result": {
                    "headers": [
                      "name",
                      "city",
                      "note"
                    ],
                    "rows": [
                      [
                        "Ada",
                        "London",
                        "likes tea, coffee"
                      ],
                      [
                        "Lin",
                        "Taipei",
                        "said \"hello\""
                      ]
                    ],
                    "records": [
                      {
                        "name": "Ada",
                        "city": "London",
                        "note": "likes tea, coffee"
                      },
                      {
                        "name": "Lin",
                        "city": "Taipei",
                        "note": "said \"hello\""
                      }
                    ],
                    "rowCount": 2,
                    "columnCount": 3
                  },
                  "provenance": {
                    "inputSha256": "0b1b04d0728b29a45992b707f68c093fddd809329d42cc9303379e4605f428d9",
                    "outputSha256": "b24ca76e284c99db2096924ea8bbf42ff2beaa1b39143451cbd020199f6ace99",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/csv-serialize": {
      "post": {
        "operationId": "mpp_csv_serialize",
        "summary": "Spreadsheet-safe CSV serializer",
        "description": "WHEN TO USE: Export scalar rows to CSV with RFC 4180 quoting and spreadsheet formula protection. By default, prefixes an apostrophe to string cells/headers beginning with =,+,-,@, their full-width variants, tab, CR, or LF (also after leading whitespace). Numeric values remain numeric; null becomes an empty cell. escapeFormulas=false is an explicit opt-out for trusted machine-only data; no escaping is universally safe after spreadsheet re-save. Optional unique headers; rectangular rows; CRLF and final newline by default. Maximum 1,000 rows, 100 columns, 100,000 output characters.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/csv-serialize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "export JSON rows as CSV",
            "escape spreadsheet formula cells"
          ],
          "whenToUse": [
            "Serialize scalar rows with default formula-trigger escaping."
          ],
          "whenNotToUse": [
            "A guarantee of safety after spreadsheet re-save or XLSX generation."
          ],
          "capabilities": [
            "csv-serialize",
            "export JSON rows as CSV",
            "escape spreadsheet formula cells"
          ],
          "related": [
            "csv-parse"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "rows": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "maxItems": 100,
                      "type": "array",
                      "items": {
                        "type": [
                          "string",
                          "number",
                          "boolean",
                          "null"
                        ]
                      }
                    }
                  },
                  "headers": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 2048
                    }
                  },
                  "delimiter": {
                    "default": ",",
                    "type": "string",
                    "enum": [
                      ",",
                      ";",
                      "\t",
                      "|"
                    ]
                  },
                  "newline": {
                    "default": "crlf",
                    "type": "string",
                    "enum": [
                      "crlf",
                      "lf"
                    ]
                  },
                  "finalNewline": {
                    "default": true,
                    "type": "boolean"
                  },
                  "escapeFormulas": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "rows"
                ],
                "additionalProperties": false
              },
              "example": {
                "headers": [
                  "customer",
                  "amount",
                  "comment"
                ],
                "rows": [
                  [
                    "Ada",
                    49.5,
                    "paid"
                  ],
                  [
                    "Lin",
                    20,
                    "=HYPERLINK(\"https://example.com\")"
                  ]
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "csv-serialize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "csv": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "rowCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "columnCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "escapedCells": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "csv",
                        "rowCount",
                        "columnCount",
                        "escapedCells"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "csv-serialize",
                  "version": "0.29.0",
                  "result": {
                    "csv": "customer,amount,comment\r\nAda,49.5,paid\r\nLin,20,\"'=HYPERLINK(\"\"https://example.com\"\")\"\r\n",
                    "rowCount": 2,
                    "columnCount": 3,
                    "escapedCells": 1
                  },
                  "provenance": {
                    "inputSha256": "3ac7682b1e2c885963261d2758d3a28f83e723047243636d594ae8ff781905b6",
                    "outputSha256": "1ebe7c7cde33757d848c02399325fab0eff66cdc158a9645d9bc8e9a66f5508a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/unicode-normalize": {
      "post": {
        "operationId": "mpp_unicode_normalize",
        "summary": "Normalize Unicode",
        "description": "Use before comparing or indexing Unicode text. Applies exactly NFC, NFD, NFKC, or NFKD and reports UTF-16 lengths. Compatibility forms can change meaning; this is not transliteration, case folding, or confusable detection.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/unicode-normalize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "normalize Unicode NFC NFKC",
            "compare composed accented text"
          ],
          "whenToUse": [
            "Apply an explicit Unicode normalization form."
          ],
          "whenNotToUse": [
            "Transliteration, confusable detection, or case folding."
          ],
          "capabilities": [
            "unicode-normalize",
            "normalize Unicode NFC NFKC",
            "compare composed accented text"
          ],
          "related": [
            "whitespace-clean",
            "lines-dedupe"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "form": {
                    "default": "NFC",
                    "type": "string",
                    "enum": [
                      "NFC",
                      "NFD",
                      "NFKC",
                      "NFKD"
                    ]
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Café ①",
                "form": "NFKC"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "unicode-normalize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 1800000
                        },
                        "form": {
                          "type": "string",
                          "enum": [
                            "NFC",
                            "NFD",
                            "NFKC",
                            "NFKD"
                          ]
                        },
                        "changed": {
                          "type": "boolean"
                        },
                        "originalCodeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "normalizedCodeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1800000
                        }
                      },
                      "required": [
                        "text",
                        "form",
                        "changed",
                        "originalCodeUnits",
                        "normalizedCodeUnits"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "unicode-normalize",
                  "version": "0.29.0",
                  "result": {
                    "text": "Café 1",
                    "form": "NFKC",
                    "changed": true,
                    "originalCodeUnits": 7,
                    "normalizedCodeUnits": 6
                  },
                  "provenance": {
                    "inputSha256": "466d81292786e9dc2f185494fd308d3c03e3665b2c6126a7cd86c9926cd03a83",
                    "outputSha256": "874251a1cf210b12e2c1396cb1dc8fb0b8ef18991b5ece95099fa8654b500cb9",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/text-chunk": {
      "post": {
        "operationId": "mpp_text_chunk",
        "summary": "Chunk text with overlap",
        "description": "Use to split a document into bounded Unicode-code-point windows with configurable overlap. Exact source slices use UTF-16 offsets, so adjacent windows can be verified without losing source characters. Not tokenization or grapheme segmentation. At most 2,000 chunks and 500,000 returned UTF-16 units.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-chunk.md"
        },
        "x-agent-discovery": {
          "intents": [
            "split document for RAG retrieval",
            "overlapping chunks with source offsets"
          ],
          "whenToUse": [
            "Create bounded code-point windows with verifiable UTF-16 source offsets."
          ],
          "whenNotToUse": [
            "Tokenizer-accurate token budgets or semantic passage segmentation."
          ],
          "capabilities": [
            "text-chunk",
            "split document for RAG retrieval",
            "overlapping chunks with source offsets"
          ],
          "related": [
            "markdown-outline",
            "html-to-text"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "maxChars": {
                    "default": 1000,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "overlapChars": {
                    "default": 0,
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9999
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Agents need exact source offsets for retrieval.",
                "maxChars": 20,
                "overlapChars": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-chunk",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        },
                        "originalCodeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "originalCodePoints": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "chunkCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2000
                        },
                        "chunks": {
                          "maxItems": 2000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1999
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "codePoints": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 10000
                              },
                              "text": {
                                "type": "string",
                                "maxLength": 20000
                              }
                            },
                            "required": [
                              "index",
                              "start",
                              "end",
                              "codePoints",
                              "text"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "offsetUnit",
                        "originalCodeUnits",
                        "originalCodePoints",
                        "chunkCount",
                        "chunks"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-chunk",
                  "version": "0.29.0",
                  "result": {
                    "offsetUnit": "UTF-16 code units; zero-based, end-exclusive",
                    "originalCodeUnits": 47,
                    "originalCodePoints": 47,
                    "chunkCount": 3,
                    "chunks": [
                      {
                        "index": 0,
                        "start": 0,
                        "end": 20,
                        "codePoints": 20,
                        "text": "Agents need exact so"
                      },
                      {
                        "index": 1,
                        "start": 15,
                        "end": 35,
                        "codePoints": 20,
                        "text": "ct source offsets fo"
                      },
                      {
                        "index": 2,
                        "start": 30,
                        "end": 47,
                        "codePoints": 17,
                        "text": "ts for retrieval."
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "fbd009549808504641990274a3acdffd9280cad74caa8c7614b5cea66a9be5f1",
                    "outputSha256": "7b3184db21762bfcd8b96cd0555cb3af852650c154c8d79c1145d6d37d48dd2a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/text-metrics": {
      "post": {
        "operationId": "mpp_text_metrics",
        "summary": "Measure text",
        "description": "Use for deterministic document sizing and basic QA. Counts UTF-16 units, Unicode code points, UTF-8 bytes, whitespace, logical lines, blank-line-separated paragraphs, and word-like spans. Words use Unicode letters/numbers with internal apostrophes; this is not linguistic segmentation, token counting, or a readability score. Empty text has zero lines; a final newline adds an empty line.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-metrics.md"
        },
        "x-agent-discovery": {
          "intents": [
            "count characters bytes words lines",
            "measure document size"
          ],
          "whenToUse": [
            "Measure deterministic Unicode and byte sizes with basic word-like counts."
          ],
          "whenNotToUse": [
            "Model token counts, language-specific segmentation, or readability scoring."
          ],
          "capabilities": [
            "text-metrics",
            "count characters bytes words lines",
            "measure document size"
          ],
          "related": [
            "text-chunk"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "One small agent.\n\nTwo useful tools.\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-metrics",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "codeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "codePoints": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "utf8Bytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 400000
                        },
                        "whitespaceCodePoints": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "lines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "blankLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "nonBlankLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "paragraphs": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "wordLikeSpans": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "uniqueWordsCaseInsensitive": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        }
                      },
                      "required": [
                        "codeUnits",
                        "codePoints",
                        "utf8Bytes",
                        "whitespaceCodePoints",
                        "lines",
                        "blankLines",
                        "nonBlankLines",
                        "paragraphs",
                        "wordLikeSpans",
                        "uniqueWordsCaseInsensitive"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-metrics",
                  "version": "0.29.0",
                  "result": {
                    "codeUnits": 36,
                    "codePoints": 36,
                    "utf8Bytes": 36,
                    "whitespaceCodePoints": 7,
                    "lines": 4,
                    "blankLines": 2,
                    "nonBlankLines": 2,
                    "paragraphs": 2,
                    "wordLikeSpans": 6,
                    "uniqueWordsCaseInsensitive": 6
                  },
                  "provenance": {
                    "inputSha256": "614a32ac9b8d044ded2e68304252726549b5622023f0f761daaf9e0a8611ca52",
                    "outputSha256": "830d68c6a57c0493f768b277785145a404ea7b00f3df80bbd9d1cda47217659c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/lines-dedupe": {
      "post": {
        "operationId": "mpp_lines_dedupe",
        "summary": "Deduplicate lines",
        "description": "Use to remove repeated records from newline-delimited text while keeping the first original spelling and order. Comparison optionally trims whitespace and uses locale-independent lowercase. Output separators become LF; no fuzzy matching or Unicode normalization. Empty text has zero lines; a trailing newline represents a final blank line.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/lines-dedupe.md"
        },
        "x-agent-discovery": {
          "intents": [
            "remove duplicate text lines",
            "deduplicate newline records"
          ],
          "whenToUse": [
            "Keep the first spelling and order with optional trim/lowercase comparison."
          ],
          "whenNotToUse": [
            "Fuzzy entity resolution or Unicode normalization."
          ],
          "capabilities": [
            "lines-dedupe",
            "remove duplicate text lines",
            "deduplicate newline records"
          ],
          "related": [
            "unicode-normalize",
            "whitespace-clean"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "trimForComparison": {
                    "default": false,
                    "type": "boolean"
                  },
                  "caseSensitive": {
                    "default": true,
                    "type": "boolean"
                  },
                  "dropEmpty": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Alpha\nBeta\n alpha \nBeta",
                "trimForComparison": true,
                "caseSensitive": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "lines-dedupe",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "inputLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "outputLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "duplicateLinesRemoved": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "emptyLinesRemoved": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "keptOriginalLineNumbers": {
                          "maxItems": 100001,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100001
                          }
                        }
                      },
                      "required": [
                        "text",
                        "inputLines",
                        "outputLines",
                        "duplicateLinesRemoved",
                        "emptyLinesRemoved",
                        "keptOriginalLineNumbers"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "lines-dedupe",
                  "version": "0.29.0",
                  "result": {
                    "text": "Alpha\nBeta",
                    "inputLines": 4,
                    "outputLines": 2,
                    "duplicateLinesRemoved": 2,
                    "emptyLinesRemoved": 0,
                    "keptOriginalLineNumbers": [
                      1,
                      2
                    ]
                  },
                  "provenance": {
                    "inputSha256": "c2483912e3f47691860b328a56b737710dd3ddfe2215cd13d62d858978378a9b",
                    "outputSha256": "0b13ea8b088f1220910f61475e1909bf90ca5a39f789eab1977ba255f1716b14",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/keywords-extract": {
      "post": {
        "operationId": "mpp_keywords_extract",
        "summary": "Extract frequency keywords",
        "description": "Use to produce a small, reproducible frequency index for a document. Counts Unicode word-like spans containing letters, lowercases without stemming, optionally filters a fixed English stop list plus your stop words, and sorts by frequency then first occurrence. No semantic ranking, language detection, phrase extraction, or AI. First offsets refer to original UTF-16 text.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/keywords-extract.md"
        },
        "x-agent-discovery": {
          "intents": [
            "extract frequent words",
            "rank document content words by frequency excluding common stopwords",
            "frequency keyword index"
          ],
          "whenToUse": [
            "Count word-like spans with optional stopword filtering."
          ],
          "whenNotToUse": [
            "Semantic keywords, sentiment, topic modeling, or language detection."
          ],
          "capabilities": [
            "keywords-extract",
            "extract frequent words",
            "rank document content words by frequency excluding common stopwords",
            "frequency keyword index"
          ],
          "related": [
            "text-metrics"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "limit": {
                    "default": 20,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "minLength": {
                    "default": 3,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 50
                  },
                  "useEnglishStopWords": {
                    "default": true,
                    "type": "boolean"
                  },
                  "stopWords": {
                    "default": [],
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Agents call tools. Reliable tools help agents. Agents need reliable APIs.",
                "limit": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "keywords-extract",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        },
                        "totalCandidates": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "uniqueCandidates": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "keywords": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "keyword": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 200000
                              },
                              "count": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100000
                              },
                              "firstOffset": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              }
                            },
                            "required": [
                              "keyword",
                              "count",
                              "firstOffset"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "offsetUnit",
                        "totalCandidates",
                        "uniqueCandidates",
                        "keywords"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "keywords-extract",
                  "version": "0.29.0",
                  "result": {
                    "offsetUnit": "UTF-16 code units; zero-based, end-exclusive",
                    "totalCandidates": 11,
                    "uniqueCandidates": 7,
                    "keywords": [
                      {
                        "keyword": "agents",
                        "count": 3,
                        "firstOffset": 0
                      },
                      {
                        "keyword": "tools",
                        "count": 2,
                        "firstOffset": 12
                      },
                      {
                        "keyword": "reliable",
                        "count": 2,
                        "firstOffset": 19
                      },
                      {
                        "keyword": "call",
                        "count": 1,
                        "firstOffset": 7
                      },
                      {
                        "keyword": "help",
                        "count": 1,
                        "firstOffset": 34
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "e1093d85e7862788bef58f9027d758d036bcc705d5118f97af758a40bb8675b7",
                    "outputSha256": "b6b220e1827e739ce3d78dd6b3978b76181d974a5e166c9f331843b591d5e677",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/lines-diff": {
      "post": {
        "operationId": "mpp_lines_diff",
        "summary": "Diff bounded line sequences",
        "description": "Use for auditable changes between small documents. Computes a minimal insertion/deletion script by bounded longest-common-subsequence, with one-based old/new line numbers; ties delete first. Maximum 300 lines and 30,000 UTF-16 units per document. Compares line content exactly but ignores CR/LF separator style; a final newline is an additional empty line. Not a byte diff, patch file, or fuzzy diff.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/lines-diff.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compare two text versions for added and removed lines",
            "minimal line insertion deletion diff"
          ],
          "whenToUse": [
            "Inspect exact bounded line changes with source line numbers."
          ],
          "whenNotToUse": [
            "Large files, fuzzy matching, byte comparison, or executable patch output."
          ],
          "capabilities": [
            "lines-diff",
            "compare two text versions for added and removed lines",
            "minimal line insertion deletion diff"
          ],
          "related": [
            "whitespace-clean"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "before": {
                    "type": "string",
                    "maxLength": 30000
                  },
                  "after": {
                    "type": "string",
                    "maxLength": 30000
                  }
                },
                "required": [
                  "before",
                  "after"
                ],
                "additionalProperties": false
              },
              "example": {
                "before": "status: pending\nowner: agent",
                "after": "status: ready\nowner: agent\nverified: yes"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "lines-diff",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "equal": {
                          "type": "boolean"
                        },
                        "beforeLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 300
                        },
                        "afterLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 300
                        },
                        "inserted": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 300
                        },
                        "deleted": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 300
                        },
                        "unchanged": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 300
                        },
                        "operations": {
                          "maxItems": 600,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "equal",
                                  "delete",
                                  "insert"
                                ]
                              },
                              "text": {
                                "type": "string",
                                "maxLength": 30000
                              },
                              "oldLine": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 300
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "newLine": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 300
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "kind",
                              "text",
                              "oldLine",
                              "newLine"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "equal",
                        "beforeLines",
                        "afterLines",
                        "inserted",
                        "deleted",
                        "unchanged",
                        "operations"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "lines-diff",
                  "version": "0.29.0",
                  "result": {
                    "equal": false,
                    "beforeLines": 2,
                    "afterLines": 3,
                    "inserted": 2,
                    "deleted": 1,
                    "unchanged": 1,
                    "operations": [
                      {
                        "kind": "delete",
                        "text": "status: pending",
                        "oldLine": 1,
                        "newLine": null
                      },
                      {
                        "kind": "insert",
                        "text": "status: ready",
                        "oldLine": null,
                        "newLine": 1
                      },
                      {
                        "kind": "equal",
                        "text": "owner: agent",
                        "oldLine": 2,
                        "newLine": 2
                      },
                      {
                        "kind": "insert",
                        "text": "verified: yes",
                        "oldLine": null,
                        "newLine": 3
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "068d2614e67a7711f69ba149a0078057a3d513739d4cd29472e862844c79cf7e",
                    "outputSha256": "12f9ddb453a70083094c4adc8a8fa2a5961c67eb609a6f53a7db12c8d8d35d24",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/markdown-outline": {
      "post": {
        "operationId": "mpp_markdown_outline",
        "summary": "Outline Markdown headings",
        "description": "Use to build a lightweight navigation index or section slicer. Finds ATX headings (# through ######) with up to three leading spaces, ignores fenced code, and supplies parent indexes and exact section offsets. Heading text remains inline Markdown. Does not parse Setext headings, indented code, block quotes, HTML blocks, or a full CommonMark AST. At most 5,000 headings.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/markdown-outline.md"
        },
        "x-agent-discovery": {
          "intents": [
            "extract Markdown headings",
            "document section outline"
          ],
          "whenToUse": [
            "Find supported ATX headings and exact section offsets."
          ],
          "whenNotToUse": [
            "A complete CommonMark AST or Setext/HTML heading support."
          ],
          "capabilities": [
            "markdown-outline",
            "extract Markdown headings",
            "document section outline"
          ],
          "related": [
            "markdown-links",
            "text-chunk"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string",
                    "maxLength": 100000
                  }
                },
                "required": [
                  "markdown"
                ],
                "additionalProperties": false
              },
              "example": {
                "markdown": "# Guide\nIntroduction\n## Install\nRun setup.\n## Usage\nCall the API."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "markdown-outline",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        },
                        "headings": {
                          "maxItems": 5000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 4999
                              },
                              "level": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 6
                              },
                              "title": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "line": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100001
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "headingEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "sectionEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "parentIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 4999
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "index",
                              "level",
                              "title",
                              "line",
                              "start",
                              "headingEnd",
                              "sectionEnd",
                              "parentIndex"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 5000
                        }
                      },
                      "required": [
                        "offsetUnit",
                        "headings",
                        "count"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "markdown-outline",
                  "version": "0.29.0",
                  "result": {
                    "offsetUnit": "UTF-16 code units; zero-based, end-exclusive",
                    "headings": [
                      {
                        "index": 0,
                        "level": 1,
                        "title": "Guide",
                        "line": 1,
                        "start": 0,
                        "headingEnd": 7,
                        "sectionEnd": 65,
                        "parentIndex": null
                      },
                      {
                        "index": 1,
                        "level": 2,
                        "title": "Install",
                        "line": 3,
                        "start": 21,
                        "headingEnd": 31,
                        "sectionEnd": 43,
                        "parentIndex": 0
                      },
                      {
                        "index": 2,
                        "level": 2,
                        "title": "Usage",
                        "line": 5,
                        "start": 43,
                        "headingEnd": 51,
                        "sectionEnd": 65,
                        "parentIndex": 0
                      }
                    ],
                    "count": 3
                  },
                  "provenance": {
                    "inputSha256": "1bc063ea69e10dab37ead6849f6d6084149d1e6775154229f1e5f4a1e8ad91cb",
                    "outputSha256": "ae2b47c73e4834f57c2305f128dd760962088584cdbfc9c140e5e175971b2dc3",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/markdown-links": {
      "post": {
        "operationId": "mpp_markdown_links",
        "summary": "Extract Markdown links",
        "description": "Use to inventory explicit Markdown links without fetching them. Supports single-line inline links/images with non-nested labels, bare or angle-bracket destinations, balanced destination parentheses to depth 8, quoted titles, full/collapsed references with single-line definitions, and http(s) autolinks. Ignores fenced/inline code. No shortcut references, nested labels, HTML links, indented code, or full CommonMark parsing. URLs are untrusted, unvalidated strings; entities stay literal. Maximum 5,000 links, definitions, and unresolved references each.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/markdown-links.md"
        },
        "x-agent-discovery": {
          "intents": [
            "extract links from Markdown",
            "inventory reference links"
          ],
          "whenToUse": [
            "Collect supported explicit links and unresolved references without fetching."
          ],
          "whenNotToUse": [
            "Link availability checks, full CommonMark, or URL safety certification."
          ],
          "capabilities": [
            "markdown-links",
            "extract links from Markdown",
            "inventory reference links"
          ],
          "related": [
            "url-inspect",
            "markdown-outline"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string",
                    "maxLength": 100000
                  }
                },
                "required": [
                  "markdown"
                ],
                "additionalProperties": false
              },
              "example": {
                "markdown": "[API](https://example.com/api \"API docs\")\n[guide][g]\n\n[g]: https://example.com/guide"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "markdown-links",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        },
                        "links": {
                          "maxItems": 5000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "inline",
                                  "reference",
                                  "autolink"
                                ]
                              },
                              "image": {
                                "type": "boolean"
                              },
                              "label": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "title": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 100000
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "line": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100001
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              }
                            },
                            "required": [
                              "kind",
                              "image",
                              "label",
                              "url",
                              "title",
                              "line",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "definitions": {
                          "maxItems": 5000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "maxLength": 200000
                              },
                              "url": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "title": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 100000
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "line": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100001
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              }
                            },
                            "required": [
                              "id",
                              "url",
                              "title",
                              "line",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "unresolvedReferences": {
                          "maxItems": 5000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "maxLength": 200000
                              },
                              "label": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "line": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100001
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              }
                            },
                            "required": [
                              "id",
                              "label",
                              "line",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "offsetUnit",
                        "links",
                        "definitions",
                        "unresolvedReferences"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "markdown-links",
                  "version": "0.29.0",
                  "result": {
                    "offsetUnit": "UTF-16 code units; zero-based, end-exclusive",
                    "links": [
                      {
                        "kind": "inline",
                        "image": false,
                        "label": "API",
                        "url": "https://example.com/api",
                        "title": "API docs",
                        "line": 1,
                        "start": 0,
                        "end": 41
                      },
                      {
                        "kind": "reference",
                        "image": false,
                        "label": "guide",
                        "url": "https://example.com/guide",
                        "title": null,
                        "line": 2,
                        "start": 42,
                        "end": 52
                      }
                    ],
                    "definitions": [
                      {
                        "id": "g",
                        "url": "https://example.com/guide",
                        "title": null,
                        "line": 4,
                        "start": 54,
                        "end": 84
                      }
                    ],
                    "unresolvedReferences": []
                  },
                  "provenance": {
                    "inputSha256": "ccee95d894907769f54aaf1e360e6c80ab1bf42b2122653d6b199624145b3914",
                    "outputSha256": "1bf4ed356d3d8cef041e5a8a5485108223c97e16499cb0b6b975c88eaf8a1414",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/html-to-text": {
      "post": {
        "operationId": "mpp_html_to_text",
        "summary": "Extract HTML fragment text",
        "description": "Use to flatten supplied HTML snippets into readable text. Uses parse5 HTML parsing, decodes entities, excludes script/style/template/noscript, optionally includes image alt text, and collapses source whitespace. Block elements and br yield line breaks or spaces. No network, CSS/layout/visibility computation, sanitization guarantee, or browser rendering; hidden elements can remain. Input is parsed as an HTML fragment. Conservative limits: 1,000 less-than characters, 64 lexically open tags (explicitly close optional-end tags), and 4,096 visited parser nodes.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/html-to-text.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert HTML snippet to plain text",
            "extract readable supplied HTML"
          ],
          "whenToUse": [
            "Parse provided HTML fragments locally and omit script/style/template/noscript text."
          ],
          "whenNotToUse": [
            "URL scraping, browser-rendered visibility, or HTML security sanitization."
          ],
          "capabilities": [
            "html-to-text",
            "convert HTML snippet to plain text",
            "extract readable supplied HTML"
          ],
          "related": [
            "text-chunk",
            "whitespace-clean"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "html": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "mode": {
                    "default": "block-lines",
                    "type": "string",
                    "enum": [
                      "block-lines",
                      "single-line"
                    ]
                  },
                  "includeImageAlt": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "html"
                ],
                "additionalProperties": false
              },
              "example": {
                "html": "<h1>Report &amp; results</h1><p>Ready <strong>now</strong>.</p><script>alert(1)</script>",
                "mode": "block-lines"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "html-to-text",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 200000
                        },
                        "codeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 200000
                        },
                        "discardedElements": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "mode": {
                          "type": "string",
                          "enum": [
                            "block-lines",
                            "single-line"
                          ]
                        }
                      },
                      "required": [
                        "text",
                        "codeUnits",
                        "discardedElements",
                        "mode"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "html-to-text",
                  "version": "0.29.0",
                  "result": {
                    "text": "Report & results\nReady now.",
                    "codeUnits": 27,
                    "discardedElements": 1,
                    "mode": "block-lines"
                  },
                  "provenance": {
                    "inputSha256": "deb645af679983a18b1236c8c18ec796a8bff4badfaafcafb798490132c40238",
                    "outputSha256": "27d20e905eff93c0e09ad510a44fdff2bc51684c4132d5c34b74b2674a706e67",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/template-render": {
      "post": {
        "operationId": "mpp_template_render",
        "summary": "Render literal templates",
        "description": "Use to fill deterministic text templates without evaluating code. Replaces only exact {{name}} placeholders, where names use ASCII letters/digits/underscore/dot/hyphen and start with a letter or underscore. Values are literal strings and are never re-expanded or escaped for HTML/SQL. All recognized variables must exist; other brace syntax stays literal. At most 1,000 variables, 5,000 replacements, 200,000 value units, and 500,000 output units.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/template-render.md"
        },
        "x-agent-discovery": {
          "intents": [
            "fill literal text placeholders",
            "render deterministic template"
          ],
          "whenToUse": [
            "Substitute literal named values without evaluating expressions."
          ],
          "whenNotToUse": [
            "HTML/SQL escaping, recursive templates, or executable template languages."
          ],
          "capabilities": [
            "template-render",
            "fill literal text placeholders",
            "render deterministic template"
          ],
          "related": [
            "json-schema-check"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "template": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "variables": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,63}$"
                    },
                    "additionalProperties": {
                      "type": "string",
                      "maxLength": 100000
                    }
                  }
                },
                "required": [
                  "template",
                  "variables"
                ],
                "additionalProperties": false
              },
              "example": {
                "template": "Hello {{name}}. Job {{job.id}} is {{status}}.",
                "variables": {
                  "name": "Agent",
                  "job.id": "42",
                  "status": "ready"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "template-render",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 500000
                        },
                        "replacements": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 5000
                        },
                        "usedVariables": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,63}$"
                          }
                        },
                        "unusedVariables": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,63}$"
                          }
                        }
                      },
                      "required": [
                        "text",
                        "replacements",
                        "usedVariables",
                        "unusedVariables"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "template-render",
                  "version": "0.29.0",
                  "result": {
                    "text": "Hello Agent. Job 42 is ready.",
                    "replacements": 3,
                    "usedVariables": [
                      "name",
                      "job.id",
                      "status"
                    ],
                    "unusedVariables": []
                  },
                  "provenance": {
                    "inputSha256": "74c5341f54ebf864062d826d738704c9fe696c156245de26dc47c5706e153e36",
                    "outputSha256": "d560ec304b0aa814026d40d835fd6f23ee29f356291f0cfdca3296cd2cfda8d7",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/pii-redact": {
      "post": {
        "operationId": "mpp_pii_redact",
        "summary": "Redact common PII patterns",
        "description": "Use as a review aid before inspecting logs or sample text. Replaces selected ASCII email, formatted US phone, XXX-XX-XXXX SSN-shaped, and valid dotted IPv4 patterns with fixed labels; returns original-source offsets without match values. Phone patterns require separators; SSN patterns do not validate issuance. Non-exhaustive heuristics can miss PII and produce false positives. Never a security, compliance, or anonymization guarantee. Maximum 10,000 matches.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/pii-redact.md"
        },
        "x-agent-discovery": {
          "intents": [
            "redact common personal data patterns",
            "mask email phone SSN IPv4"
          ],
          "whenToUse": [
            "Aid review by masking a bounded set of common ASCII patterns."
          ],
          "whenNotToUse": [
            "Complete anonymization, legal compliance, or exhaustive PII detection."
          ],
          "capabilities": [
            "pii-redact",
            "redact common personal data patterns",
            "mask email phone SSN IPv4"
          ],
          "related": [
            "text-chunk"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "types": {
                    "default": [
                      "email",
                      "us-phone"
                    ],
                    "minItems": 1,
                    "maxItems": 4,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "email",
                        "us-phone",
                        "us-ssn",
                        "ipv4"
                      ]
                    }
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Email alex@example.com or call (415) 555-2671. Host: 192.168.1.20",
                "types": [
                  "email",
                  "us-phone",
                  "ipv4"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "pii-redact",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 300000
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        },
                        "count": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 10000
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "email": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 10000
                            },
                            "usPhone": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 10000
                            },
                            "usSsn": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 10000
                            },
                            "ipv4": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 10000
                            }
                          },
                          "required": [
                            "email",
                            "usPhone",
                            "usSsn",
                            "ipv4"
                          ],
                          "additionalProperties": false
                        },
                        "redactions": {
                          "maxItems": 10000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "email",
                                  "us-phone",
                                  "us-ssn",
                                  "ipv4"
                                ]
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 100000
                              },
                              "replacement": {
                                "type": "string",
                                "enum": [
                                  "[EMAIL]",
                                  "[US_PHONE]",
                                  "[US_SSN]",
                                  "[IPV4]"
                                ]
                              }
                            },
                            "required": [
                              "type",
                              "start",
                              "end",
                              "replacement"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "warning": {
                          "type": "string",
                          "const": "Pattern-only redaction is non-exhaustive and can miss personal data or redact non-personal text. Do not rely on it as a security, compliance, or anonymization guarantee."
                        }
                      },
                      "required": [
                        "text",
                        "offsetUnit",
                        "count",
                        "counts",
                        "redactions",
                        "warning"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "pii-redact",
                  "version": "0.29.0",
                  "result": {
                    "text": "Email [EMAIL] or call [US_PHONE]. Host: [IPV4]",
                    "offsetUnit": "UTF-16 code units; zero-based, end-exclusive",
                    "count": 3,
                    "counts": {
                      "email": 1,
                      "usPhone": 1,
                      "usSsn": 0,
                      "ipv4": 1
                    },
                    "redactions": [
                      {
                        "type": "email",
                        "start": 6,
                        "end": 22,
                        "replacement": "[EMAIL]"
                      },
                      {
                        "type": "us-phone",
                        "start": 31,
                        "end": 45,
                        "replacement": "[US_PHONE]"
                      },
                      {
                        "type": "ipv4",
                        "start": 53,
                        "end": 65,
                        "replacement": "[IPV4]"
                      }
                    ],
                    "warning": "Pattern-only redaction is non-exhaustive and can miss personal data or redact non-personal text. Do not rely on it as a security, compliance, or anonymization guarantee."
                  },
                  "provenance": {
                    "inputSha256": "0d19138edb2e9fa39d38a91b2e8c426bca6d4a4d1835907c24f4870e848417b1",
                    "outputSha256": "6fee41bce2920ef0b94b502c04da6a3d876729b5195cade74c92883778ff91a2",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/whitespace-clean": {
      "post": {
        "operationId": "mpp_whitespace_clean",
        "summary": "Clean document whitespace",
        "description": "Use for predictable whitespace cleanup before diffing or storing text. Normalizes CR/LF separators to LF or CRLF, optionally collapses ASCII spaces/tabs, trims selected line edges, limits consecutive blank lines, and removes outer blank lines. Blank lines contain only spaces/tabs; other Unicode whitespace is preserved. Set maxBlankLines to null to preserve every blank line. This can change indentation-sensitive documents.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/whitespace-clean.md"
        },
        "x-agent-discovery": {
          "intents": [
            "normalize whitespace line endings",
            "trim document blank lines"
          ],
          "whenToUse": [
            "Apply explicit line separator and ASCII whitespace cleanup."
          ],
          "whenNotToUse": [
            "Preserving all indentation-sensitive semantics automatically."
          ],
          "capabilities": [
            "whitespace-clean",
            "normalize whitespace line endings",
            "trim document blank lines"
          ],
          "related": [
            "lines-diff",
            "unicode-normalize"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "lineEnding": {
                    "default": "lf",
                    "type": "string",
                    "enum": [
                      "lf",
                      "crlf"
                    ]
                  },
                  "trimLineEdges": {
                    "default": "right",
                    "type": "string",
                    "enum": [
                      "none",
                      "right",
                      "both"
                    ]
                  },
                  "collapseHorizontalWhitespace": {
                    "default": false,
                    "type": "boolean"
                  },
                  "maxBlankLines": {
                    "default": 2,
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 20
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "trimOuterBlankLines": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "  Keep indent  \r\n\r\n\r\nNext\t  word \r\n",
                "collapseHorizontalWhitespace": true,
                "maxBlankLines": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "whitespace-clean",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 200000
                        },
                        "changed": {
                          "type": "boolean"
                        },
                        "originalCodeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "resultCodeUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 200000
                        },
                        "inputLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "outputLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100001
                        },
                        "lineEnding": {
                          "type": "string",
                          "enum": [
                            "lf",
                            "crlf"
                          ]
                        }
                      },
                      "required": [
                        "text",
                        "changed",
                        "originalCodeUnits",
                        "resultCodeUnits",
                        "inputLines",
                        "outputLines",
                        "lineEnding"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "whitespace-clean",
                  "version": "0.29.0",
                  "result": {
                    "text": " Keep indent\n\nNext word",
                    "changed": true,
                    "originalCodeUnits": 35,
                    "resultCodeUnits": 23,
                    "inputLines": 5,
                    "outputLines": 3,
                    "lineEnding": "lf"
                  },
                  "provenance": {
                    "inputSha256": "082a1ccf8ba7deeac006ca84e9cd89c620dcdd69898f7e947a445dfa9c303ba0",
                    "outputSha256": "a4d5b09671c6b6b3d6d9827310dbdb380a7d486b80675b6c0a55f8cc2f012667",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/yaml-to-json": {
      "post": {
        "operationId": "mpp_yaml_to_json",
        "summary": "Yaml To Json",
        "description": "Use to turn bounded YAML 1.2 configuration into JSON before agent tool calls. Rejects duplicate keys, custom tags, non-JSON values, and aliases.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/yaml-to-json.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert YAML config into JSON",
            "parse YAML 1.2"
          ],
          "whenToUse": [
            "Convert bounded YAML configuration into a JSON object, array or scalar without aliases or custom tags."
          ],
          "whenNotToUse": [
            "Arbitrary YAML objects, alias expansion, or executable tags."
          ],
          "capabilities": [
            "yaml-to-json",
            "convert YAML config into JSON",
            "parse YAML 1.2"
          ],
          "related": [
            "json-schema-check",
            "json-to-yaml"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "yaml": {
                    "type": "string",
                    "maxLength": 20000
                  }
                },
                "required": [
                  "yaml"
                ],
                "additionalProperties": false
              },
              "example": {
                "yaml": "name: agent\nretries: 3"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "yaml-to-json",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "value": {
                          "$ref": "#/paths/~1v1~1mpp~1yaml-to-json/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        }
                      },
                      "required": [
                        "value"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1yaml-to-json/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1yaml-to-json/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "yaml-to-json",
                  "version": "0.29.0",
                  "result": {
                    "value": {
                      "name": "agent",
                      "retries": 3
                    }
                  },
                  "provenance": {
                    "inputSha256": "6dccb7a35faadb360f30610ffce468799e47eebfc7526086878cf69902de5a9c",
                    "outputSha256": "54ad11b20706b7cf42f112084c88842598a0c2b4c7cb79e8107ae5211e0b238c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-to-yaml": {
      "post": {
        "operationId": "mpp_json_to_yaml",
        "summary": "Json To Yaml",
        "description": "Use to create human-reviewable YAML 1.2 from a JSON tool result; preserves JSON scalar types and emits no aliases.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-to-yaml.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert JSON into YAML",
            "emit readable YAML configuration"
          ],
          "whenToUse": [
            "Serialize supplied JSON scalar/container values as YAML 1.2."
          ],
          "whenNotToUse": [
            "Preserving prior YAML comments, aliases, or original formatting."
          ],
          "capabilities": [
            "json-to-yaml",
            "convert JSON into YAML",
            "emit readable YAML configuration"
          ],
          "related": [
            "yaml-to-json"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "value": {
                    "$ref": "#/paths/~1v1~1mpp~1json-to-yaml/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "indent": {
                    "default": 2,
                    "type": "integer",
                    "minimum": 2,
                    "maximum": 8
                  }
                },
                "required": [
                  "value"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-to-yaml/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-to-yaml/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "value": {
                  "name": "agent",
                  "retries": 3
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-to-yaml",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "yaml": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "yaml"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-to-yaml",
                  "version": "0.29.0",
                  "result": {
                    "yaml": "name: agent\nretries: 3\n"
                  },
                  "provenance": {
                    "inputSha256": "b0c81b7f5d676de7d226abf52cc7881ea2488cd93781caffa2d89fa3219facad",
                    "outputSha256": "5777d97ab33f650c829b48c96a2a4e405271e756e0ee271289607fa5a5d98478",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-schema-check": {
      "post": {
        "operationId": "mpp_json_schema_check",
        "summary": "Json Schema Check",
        "description": "Use to validate tool output with a bounded JSON Schema subset: scalar types, objects, arrays, enum/const, limits and combinators. Rejects $ref, regex and unsupported keywords; not a full draft validator.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-schema-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "validate JSON tool output",
            "check instance against JSON Schema subset"
          ],
          "whenToUse": [
            "Validate a supplied value against the explicitly supported bounded schema subset."
          ],
          "whenNotToUse": [
            "Full JSON Schema draft conformance, $ref resolution, or regex validation."
          ],
          "capabilities": [
            "json-schema-check",
            "validate JSON tool output",
            "check instance against JSON Schema subset"
          ],
          "related": [
            "json-schema-compatibility",
            "json-patch"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "schema": {
                    "$ref": "#/paths/~1v1~1mpp~1json-schema-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "value": {
                    "$ref": "#/paths/~1v1~1mpp~1json-schema-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "schema",
                  "value"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-schema-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-schema-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "schema": {
                  "type": "object",
                  "required": [
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer"
                    }
                  },
                  "additionalProperties": false
                },
                "value": {
                  "id": 7
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-schema-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "valid": {
                          "type": "boolean"
                        },
                        "errors": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "keyword": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "path",
                              "keyword",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "dialect": {
                          "type": "string",
                          "const": "safe-json-schema-subset-v1"
                        }
                      },
                      "required": [
                        "valid",
                        "errors",
                        "dialect"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-schema-check",
                  "version": "0.29.0",
                  "result": {
                    "valid": true,
                    "errors": [],
                    "dialect": "safe-json-schema-subset-v1"
                  },
                  "provenance": {
                    "inputSha256": "971d014766eee8eca7005efb4ccfea7ec0ed8f935b36be0a8e78661e68e349de",
                    "outputSha256": "48544e032ed51afc6370091e94ab446016238de6d599c548815570845e7efd5e",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/base64-convert": {
      "post": {
        "operationId": "mpp_base64_convert",
        "summary": "Base64 Convert",
        "description": "Use to convert UTF-8 text to canonical Base64/Base64url or decode it. Rejects malformed encodings and non-UTF-8 decoded bytes.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/base64-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "encode decode base64 text",
            "convert base64url UTF-8"
          ],
          "whenToUse": [
            "Encode UTF-8 text or decode canonical base64 encodings."
          ],
          "whenNotToUse": [
            "Arbitrary binary files or cryptographic encryption."
          ],
          "capabilities": [
            "base64-convert",
            "encode decode base64 text",
            "convert base64url UTF-8"
          ],
          "related": [
            "content-digest"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "direction": {
                    "type": "string",
                    "enum": [
                      "encode",
                      "decode"
                    ]
                  },
                  "urlSafe": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text",
                  "direction"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Hello, agent",
                "direction": "encode",
                "urlSafe": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "base64-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string"
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "text",
                        "byteLength"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "base64-convert",
                  "version": "0.29.0",
                  "result": {
                    "text": "SGVsbG8sIGFnZW50",
                    "byteLength": 12
                  },
                  "provenance": {
                    "inputSha256": "4e0e9460a9100c39b78fabf62c5dca183b314f3ddb5f64973f735385f9754137",
                    "outputSha256": "d0d25ee6154f44dc80488e7e63bf61fde968d06cad53aebf97df0a118d9e97f4",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/url-inspect": {
      "post": {
        "operationId": "mpp_url_inspect",
        "summary": "Url Inspect",
        "description": "Use to parse and normalize an HTTP(S) URL without fetching it. Returns origin, IDNA host, port and query pairs. Rejects credentials; normalization does not certify URL safety.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/url-inspect.md"
        },
        "x-agent-discovery": {
          "intents": [
            "parse HTTP URL components",
            "normalize URL hostname query"
          ],
          "whenToUse": [
            "Inspect supplied HTTP(S) URLs with IDNA normalization without fetching."
          ],
          "whenNotToUse": [
            "SSRF protection, reputation verdicts, DNS lookup, or live link checks."
          ],
          "capabilities": [
            "url-inspect",
            "parse HTTP URL components",
            "normalize URL hostname query"
          ],
          "related": [
            "querystring-convert"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "maxLength": 8192
                  },
                  "removeFragment": {
                    "default": true,
                    "type": "boolean"
                  },
                  "sortQuery": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "url"
                ],
                "additionalProperties": false
              },
              "example": {
                "url": "https://EXAMPLE.com:443/a?z=2&a=1#part",
                "sortQuery": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "url-inspect",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string"
                        },
                        "origin": {
                          "type": "string"
                        },
                        "hostname": {
                          "type": "string"
                        },
                        "port": {
                          "type": "string"
                        },
                        "path": {
                          "type": "string"
                        },
                        "query": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "prefixItems": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "items": false,
                            "minItems": 2,
                            "maxItems": 2
                          }
                        },
                        "fragment": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "url",
                        "origin",
                        "hostname",
                        "port",
                        "path",
                        "query",
                        "fragment"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "url-inspect",
                  "version": "0.29.0",
                  "result": {
                    "url": "https://example.com/a?a=1&z=2",
                    "origin": "https://example.com",
                    "hostname": "example.com",
                    "port": "",
                    "path": "/a",
                    "query": [
                      [
                        "a",
                        "1"
                      ],
                      [
                        "z",
                        "2"
                      ]
                    ],
                    "fragment": ""
                  },
                  "provenance": {
                    "inputSha256": "fc8c577f79a2a523785334ddf0e12cf64b239641127dc5ff558c33023346184a",
                    "outputSha256": "a313dc97ab163bf32c33c5fd64d2825aeaeecc68d64ce2fc016b35009853a97f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/querystring-convert": {
      "post": {
        "operationId": "mpp_querystring_convert",
        "summary": "Querystring Convert",
        "description": "Use to encode query parameter pairs or decode application/x-www-form-urlencoded query strings while preserving duplicate keys and order.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/querystring-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "encode decode query parameters",
            "preserve duplicate URL query keys"
          ],
          "whenToUse": [
            "Convert ordered parameter pairs to/from form-urlencoded strings."
          ],
          "whenNotToUse": [
            "Nested bracket object conventions or URL fetching."
          ],
          "capabilities": [
            "querystring-convert",
            "encode decode query parameters",
            "preserve duplicate URL query keys"
          ],
          "related": [
            "url-inspect"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "direction": {
                        "type": "string",
                        "const": "decode"
                      },
                      "query": {
                        "type": "string",
                        "maxLength": 100000
                      }
                    },
                    "required": [
                      "direction",
                      "query"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "direction": {
                        "type": "string",
                        "const": "encode"
                      },
                      "pairs": {
                        "maxItems": 1000,
                        "type": "array",
                        "items": {
                          "type": "array",
                          "prefixItems": [
                            {
                              "type": "string",
                              "maxLength": 2048
                            },
                            {
                              "type": "string",
                              "maxLength": 8192
                            }
                          ],
                          "items": false,
                          "minItems": 2,
                          "maxItems": 2
                        }
                      },
                      "sort": {
                        "default": false,
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "direction",
                      "pairs"
                    ],
                    "additionalProperties": false
                  }
                ]
              },
              "example": {
                "direction": "decode",
                "query": "tag=one&tag=two&q=hello+world"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "querystring-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "query": {
                          "type": "string"
                        },
                        "pairs": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "prefixItems": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "items": false,
                            "minItems": 2,
                            "maxItems": 2
                          }
                        }
                      },
                      "required": [
                        "query",
                        "pairs"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "querystring-convert",
                  "version": "0.29.0",
                  "result": {
                    "query": "tag=one&tag=two&q=hello+world",
                    "pairs": [
                      [
                        "tag",
                        "one"
                      ],
                      [
                        "tag",
                        "two"
                      ],
                      [
                        "q",
                        "hello world"
                      ]
                    ]
                  },
                  "provenance": {
                    "inputSha256": "111fcf375abf0e34e89d8467017803fa5d8e6edda1bcb879cef1ba7cbef98079",
                    "outputSha256": "18b88b619e57cf36f96454a3efd13c409ba3de0f307957ec89dba1c7a2bab5ed",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/http-headers-normalize": {
      "post": {
        "operationId": "mpp_http_headers_normalize",
        "summary": "Http Headers Normalize",
        "description": "Use to validate and lowercase HTTP field names and trim field values before signing or comparing requests. Preserves repeated headers as arrays and does not combine Set-Cookie.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-headers-normalize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "normalize HTTP headers",
            "validate repeated header fields"
          ],
          "whenToUse": [
            "Validate HTTP field names and trim values while preserving repeated Set-Cookie headers and multiple values."
          ],
          "whenNotToUse": [
            "HTTP request transmission or combining Set-Cookie into one field."
          ],
          "capabilities": [
            "http-headers-normalize",
            "normalize HTTP headers",
            "validate repeated header fields"
          ],
          "related": [
            "openapi-request-check"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "headers": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256
                        },
                        {
                          "type": "string",
                          "maxLength": 8192
                        }
                      ],
                      "items": false,
                      "minItems": 2,
                      "maxItems": 2
                    }
                  }
                },
                "required": [
                  "headers"
                ],
                "additionalProperties": false
              },
              "example": {
                "headers": [
                  [
                    "Content-Type",
                    " application/json "
                  ],
                  [
                    "X-Tag",
                    "a"
                  ],
                  [
                    "x-tag",
                    "b"
                  ]
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-headers-normalize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "headers": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "names": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "headers",
                        "names"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-headers-normalize",
                  "version": "0.29.0",
                  "result": {
                    "headers": {
                      "content-type": [
                        "application/json"
                      ],
                      "x-tag": [
                        "a",
                        "b"
                      ]
                    },
                    "names": [
                      "content-type",
                      "x-tag"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "a11215cff82614f63e1c8ed1b11d5b4d4e1cef7e47e88a27cfc3a598317dcf01",
                    "outputSha256": "c47fe2f012fd910ff4b29b246e4975b71bdeecf02fb61402dc6c2986a3904c4f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/content-digest": {
      "post": {
        "operationId": "mpp_content_digest",
        "summary": "Content Digest",
        "description": "Use to fingerprint UTF-8 payloads for content-addressing, cache keys and integrity comparisons. Computes SHA-256/384/512; this is not a signature or authentication service.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/content-digest.md"
        },
        "x-agent-discovery": {
          "intents": [
            "hash text SHA256 SHA384 SHA512",
            "fingerprint payload integrity"
          ],
          "whenToUse": [
            "Compute a SHA digest of supplied UTF-8 text."
          ],
          "whenNotToUse": [
            "Authentication, digital signatures, encryption, or file downloading."
          ],
          "capabilities": [
            "content-digest",
            "hash text SHA256 SHA384 SHA512",
            "fingerprint payload integrity"
          ],
          "related": [
            "json-canonicalize"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 100000
                  },
                  "algorithm": {
                    "default": "SHA-256",
                    "type": "string",
                    "enum": [
                      "SHA-256",
                      "SHA-384",
                      "SHA-512"
                    ]
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "hello",
                "algorithm": "SHA-256"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "content-digest",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "algorithm": {
                          "type": "string"
                        },
                        "hex": {
                          "type": "string"
                        },
                        "base64": {
                          "type": "string"
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "algorithm",
                        "hex",
                        "base64",
                        "byteLength"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "content-digest",
                  "version": "0.29.0",
                  "result": {
                    "algorithm": "SHA-256",
                    "hex": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
                    "base64": "LPJNul+wow4m6DsqxbninhsWHlwfp0JecwQzYpOLmCQ=",
                    "byteLength": 5
                  },
                  "provenance": {
                    "inputSha256": "32dc8f587f9d0b79d59534d4c0955439356a01a25c9c7bbbee0b341360c024f7",
                    "outputSha256": "3b04feb68946ce52454b91f05fdf0026dda4d026a03bb7c5b9dc530ccf6026d6",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/timestamp-convert": {
      "post": {
        "operationId": "mpp_timestamp_convert",
        "summary": "Timestamp Convert",
        "description": "Use to normalize RFC3339 timestamps with an explicit offset or Unix epoch milliseconds into UTC ISO text, epoch milliseconds and epoch seconds. Rejects rollover dates and leap seconds.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/timestamp-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert timestamp epoch UTC",
            "normalize RFC3339 date offset"
          ],
          "whenToUse": [
            "Convert strict offset timestamps or epoch milliseconds into UTC."
          ],
          "whenNotToUse": [
            "Natural-language dates, missing timezones, or leap seconds."
          ],
          "capabilities": [
            "timestamp-convert",
            "convert timestamp epoch UTC",
            "normalize RFC3339 date offset"
          ],
          "related": [
            "duration-convert"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 64
                      },
                      {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      }
                    ]
                  }
                },
                "required": [
                  "value"
                ],
                "additionalProperties": false
              },
              "example": {
                "value": "2026-10-04T14:30:00-04:00"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "timestamp-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "iso": {
                          "type": "string"
                        },
                        "epochMilliseconds": {
                          "type": "number"
                        },
                        "epochSeconds": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "iso",
                        "epochMilliseconds",
                        "epochSeconds"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "timestamp-convert",
                  "version": "0.29.0",
                  "result": {
                    "iso": "2026-10-04T18:30:00.000Z",
                    "epochMilliseconds": 1791138600000,
                    "epochSeconds": 1791138600
                  },
                  "provenance": {
                    "inputSha256": "27fe29dbd2ca1ceba9a420fcf1637432ce53b78d2a2c42251db7feb97031c8df",
                    "outputSha256": "18db30fca1c0e812885bdac5dc00e010c71538792b0f553696b26d3fbe6a2505",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/duration-convert": {
      "post": {
        "operationId": "mpp_duration_convert",
        "summary": "Duration Convert",
        "description": "Use to convert fixed ISO8601 durations (days, hours, minutes, seconds) to seconds and a canonical duration. Calendar years/months/weeks and negative values are deliberately unsupported.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/duration-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert ISO8601 duration seconds",
            "normalize fixed elapsed duration"
          ],
          "whenToUse": [
            "Convert fixed day/hour/minute/second durations."
          ],
          "whenNotToUse": [
            "Calendar months, years, weeks, negative durations, or date arithmetic."
          ],
          "capabilities": [
            "duration-convert",
            "convert ISO8601 duration seconds",
            "normalize fixed elapsed duration"
          ],
          "related": [
            "timestamp-convert"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "value": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 100
                      },
                      {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 315576000000
                      }
                    ]
                  }
                },
                "required": [
                  "value"
                ],
                "additionalProperties": false
              },
              "example": {
                "value": "P1DT2H30M"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "duration-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "seconds": {
                          "type": "number"
                        },
                        "milliseconds": {
                          "type": "number"
                        },
                        "iso": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "seconds",
                        "milliseconds",
                        "iso"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "duration-convert",
                  "version": "0.29.0",
                  "result": {
                    "seconds": 95400,
                    "milliseconds": 95400000,
                    "iso": "P1DT2H30M"
                  },
                  "provenance": {
                    "inputSha256": "030b4db0748feeea638dcb701d69947537ed73badf6fda8005bc4a89b29dee94",
                    "outputSha256": "1b0fef70720f9b3ee94657602d6a31b93da7e8a2c6446e9826e806c61c8ec704",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/units-convert": {
      "post": {
        "operationId": "mpp_units_convert",
        "summary": "Units Convert",
        "description": "Use for deterministic length, mass, time, byte-size or temperature conversions in agent tool inputs. Explicit case-sensitive units distinguish MB from MiB; rejects incompatible dimensions.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/units-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert measurement units",
            "length mass bytes temperature conversion"
          ],
          "whenToUse": [
            "Convert explicitly supported compatible dimensions."
          ],
          "whenNotToUse": [
            "Currencies, exchange rates, or unit guessing."
          ],
          "capabilities": [
            "units-convert",
            "convert measurement units",
            "length mass bytes temperature conversion"
          ],
          "related": [
            "duration-convert"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "value": {
                    "type": "number"
                  },
                  "from": {
                    "type": "string",
                    "enum": [
                      "m",
                      "km",
                      "cm",
                      "mm",
                      "in",
                      "ft",
                      "yd",
                      "mi",
                      "kg",
                      "g",
                      "lb",
                      "oz",
                      "s",
                      "ms",
                      "min",
                      "h",
                      "day",
                      "B",
                      "kB",
                      "MB",
                      "GB",
                      "KiB",
                      "MiB",
                      "GiB",
                      "K",
                      "C",
                      "F"
                    ]
                  },
                  "to": {
                    "type": "string",
                    "enum": [
                      "m",
                      "km",
                      "cm",
                      "mm",
                      "in",
                      "ft",
                      "yd",
                      "mi",
                      "kg",
                      "g",
                      "lb",
                      "oz",
                      "s",
                      "ms",
                      "min",
                      "h",
                      "day",
                      "B",
                      "kB",
                      "MB",
                      "GB",
                      "KiB",
                      "MiB",
                      "GiB",
                      "K",
                      "C",
                      "F"
                    ]
                  }
                },
                "required": [
                  "value",
                  "from",
                  "to"
                ],
                "additionalProperties": false
              },
              "example": {
                "value": 1,
                "from": "MiB",
                "to": "B"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "units-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "value": {
                          "type": "number"
                        },
                        "from": {
                          "type": "string"
                        },
                        "to": {
                          "type": "string"
                        },
                        "dimension": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "value",
                        "from",
                        "to",
                        "dimension"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "units-convert",
                  "version": "0.29.0",
                  "result": {
                    "value": 1048576,
                    "from": "MiB",
                    "to": "B",
                    "dimension": "data"
                  },
                  "provenance": {
                    "inputSha256": "283e4f337eba36d2e65f0fb7cbc0b0f22ff870b5052453c9b04aec9d504751a3",
                    "outputSha256": "be9271b7b12f85591743aeaae670ca317fd4611802446a6546c7a08b8cbad333",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/semver-evaluate": {
      "post": {
        "operationId": "mpp_semver_evaluate",
        "summary": "Semver Evaluate",
        "description": "Use to compare strict Semantic Versioning versions and evaluate npm-compatible version ranges before choosing a package. Prerelease matching is excluded by default unless the range explicitly allows it.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/semver-evaluate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compare semantic versions",
            "check whether a version satisfies an npm caret dependency range"
          ],
          "whenToUse": [
            "Compare strict versions and check npm-compatible ranges."
          ],
          "whenNotToUse": [
            "Looking up package releases, vulnerabilities, or non-SemVer version systems."
          ],
          "capabilities": [
            "semver-evaluate",
            "compare semantic versions",
            "check whether a version satisfies an npm caret dependency range"
          ],
          "related": [
            "lockfile-inventory",
            "json-schema-compatibility"
          ],
          "limits": {
            "requestBytes": 131072,
            "responseBytes": 524288,
            "jsonDepth": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_TOO_LARGE",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "version": {
                    "type": "string",
                    "maxLength": 256
                  },
                  "against": {
                    "type": "string",
                    "maxLength": 256
                  },
                  "range": {
                    "type": "string",
                    "maxLength": 1024
                  },
                  "includePrerelease": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "version",
                  "against"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": "2.3.1",
                "against": "2.2.0",
                "range": "^2.0.0"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "semver-evaluate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "against": {
                          "type": "string"
                        },
                        "comparison": {
                          "type": "integer",
                          "minimum": -1,
                          "maximum": 1
                        },
                        "satisfies": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "prerelease": {
                          "type": "array",
                          "items": {
                            "type": [
                              "string",
                              "number"
                            ]
                          }
                        }
                      },
                      "required": [
                        "version",
                        "against",
                        "comparison",
                        "satisfies",
                        "prerelease"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "semver-evaluate",
                  "version": "0.29.0",
                  "result": {
                    "version": "2.3.1",
                    "against": "2.2.0",
                    "comparison": 1,
                    "satisfies": true,
                    "prerelease": []
                  },
                  "provenance": {
                    "inputSha256": "6344dd6d2cf1f4675e8f6d45100b01973e77537f2032c3c1a9b76cc85ae23e1a",
                    "outputSha256": "5976f73e251f9e706bc064e66edb7ad1e151142e4187fa32b3b175e7ee92ed3c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/openapi-lint": {
      "post": {
        "operationId": "mpp_openapi_lint",
        "summary": "OpenAPI Agent Lint",
        "description": "Find actionable agent-integration problems in supplied OpenAPI 3.1.x JSON: unique operation IDs, response shape, path parameters and security references. Paths-only lint; references are reported without resolution. At most 100 paths/200 operations/200 retained findings; not full specification validation.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/openapi-lint.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Review an OpenAPI 3.1 contract before wiring an agent client",
            "Locate repairable contract defects with JSON Pointer findings",
            "Find duplicate operation IDs, missing path parameters and response definitions"
          ],
          "whenToUse": [
            "Review an OpenAPI 3.1 contract before wiring an agent client",
            "Locate repairable contract defects with JSON Pointer findings",
            "Find duplicate operation IDs, missing path parameters and response definitions"
          ],
          "whenNotToUse": [
            "Full OpenAPI conformance or remote reference resolution",
            "Authentication/security certification"
          ],
          "capabilities": [
            "Stable finding codes and repair suggestions",
            "100 paths, 200 operations, 200 findings; 110,000 UTF-8 input bytes"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "paths": 100,
            "operations": 200,
            "effectiveParameters": 100,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1mpp~1openapi-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "document"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "openapi": "3.1.0",
                  "info": {
                    "title": "Orders",
                    "version": "1.0.0"
                  },
                  "paths": {
                    "/orders/{id}": {
                      "get": {
                        "operationId": "getOrder",
                        "summary": "Read one order",
                        "parameters": [
                          {
                            "name": "id",
                            "in": "path",
                            "required": true,
                            "schema": {
                              "type": "integer",
                              "minimum": 1
                            }
                          }
                        ],
                        "responses": {
                          "200": {
                            "description": "Order"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "openapi-lint",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "openapi-3.1-agent-lint-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "complete": {
                          "type": "boolean",
                          "const": false
                        },
                        "operationCount": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "unsupportedCount": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "suggestion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "suggestion"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "complete",
                        "operationCount",
                        "errorCount",
                        "unsupportedCount",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "openapi-lint",
                  "version": "0.29.0",
                  "result": {
                    "profile": "openapi-3.1-agent-lint-v1",
                    "passesChecks": true,
                    "complete": false,
                    "operationCount": 1,
                    "errorCount": 0,
                    "unsupportedCount": 0,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "36ca6a850c156b929adea6a02d38f21cd8a9b62818414af00e4207e5d5912c42",
                    "outputSha256": "853f3aff9faf12ac5ee5bb4739a0170f11f990db8ecfcc896233fae6eb0f5169",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/openapi-operation-inventory": {
      "post": {
        "operationId": "mpp_openapi_operation_inventory",
        "summary": "OpenAPI Operation Inventory",
        "description": "Extract a bounded agent planning inventory of methods, templates, parameters, media types, response codes, and effective security declarations from OpenAPI 3.1.x. Reports lint coverage and unresolved references; does not call endpoints or resolve schemas.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/openapi-operation-inventory.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Plan which API operations and authentication schemes an agent needs",
            "Audit operation coverage before client generation"
          ],
          "whenToUse": [
            "Plan which API operations and authentication schemes an agent needs",
            "Audit operation coverage before client generation"
          ],
          "whenNotToUse": [
            "Discovering live endpoint availability",
            "Resolving referenced parameters or testing credentials"
          ],
          "capabilities": [
            "Effective path/operation parameter overrides",
            "Declared anonymous alternatives and security inheritance"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "paths": 100,
            "operations": 200,
            "effectiveParameters": 100,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1mpp~1openapi-operation-inventory/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "document"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-operation-inventory/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-operation-inventory/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "openapi": "3.1.0",
                  "info": {
                    "title": "Orders",
                    "version": "1.0.0"
                  },
                  "paths": {
                    "/orders/{id}": {
                      "get": {
                        "operationId": "getOrder",
                        "summary": "Read one order",
                        "parameters": [
                          {
                            "name": "id",
                            "in": "path",
                            "required": true,
                            "schema": {
                              "type": "integer",
                              "minimum": 1
                            }
                          }
                        ],
                        "responses": {
                          "200": {
                            "description": "Order"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "openapi-operation-inventory",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "openapi-3.1-operation-inventory-v1"
                        },
                        "operations": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "method": {
                                "type": "string",
                                "enum": [
                                  "get",
                                  "put",
                                  "post",
                                  "delete",
                                  "options",
                                  "head",
                                  "patch",
                                  "trace"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "operationId": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "summary": {
                                "type": "string"
                              },
                              "parameters": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string"
                                    },
                                    "location": {
                                      "type": "string"
                                    },
                                    "required": {
                                      "type": "boolean"
                                    },
                                    "hasReference": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "location",
                                    "required",
                                    "hasReference"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "requestMediaTypes": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "responseCodes": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "securitySchemes": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "anonymousAllowed": {
                                "type": "boolean"
                              },
                              "securitySource": {
                                "type": "string",
                                "enum": [
                                  "operation",
                                  "document",
                                  "absent"
                                ]
                              }
                            },
                            "required": [
                              "method",
                              "path",
                              "operationId",
                              "summary",
                              "parameters",
                              "requestMediaTypes",
                              "responseCodes",
                              "securitySchemes",
                              "anonymousAllowed",
                              "securitySource"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "suggestion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "suggestion"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "operations",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "openapi-operation-inventory",
                  "version": "0.29.0",
                  "result": {
                    "profile": "openapi-3.1-operation-inventory-v1",
                    "operations": [
                      {
                        "method": "get",
                        "path": "/orders/{id}",
                        "operationId": "getOrder",
                        "summary": "Read one order",
                        "parameters": [
                          {
                            "name": "id",
                            "location": "path",
                            "required": true,
                            "hasReference": false
                          }
                        ],
                        "requestMediaTypes": [],
                        "responseCodes": [
                          "200"
                        ],
                        "securitySchemes": [],
                        "anonymousAllowed": true,
                        "securitySource": "absent"
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "36ca6a850c156b929adea6a02d38f21cd8a9b62818414af00e4207e5d5912c42",
                    "outputSha256": "4b89429d94aa232b3f033c4f56e436e180e8f5b2260005c47845ca678f47e922",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-schema-compatibility": {
      "post": {
        "operationId": "mpp_json_schema_compatibility",
        "summary": "JSON Schema Compatibility Evidence",
        "description": "Conservatively test whether all values accepted by a previous typed JSON Schema subset remain accepted by a next schema. Returns compatible only after a structural inclusion proof, incompatible only with a verified counterexample, otherwise unknown. Supports explicit single types, object/array constraints, enum/const and inclusive bounds; no refs/combinators/regex.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-schema-compatibility.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Gate an agent tool input-schema upgrade for backward acceptance",
            "Get concrete evidence for a breaking schema change"
          ],
          "whenToUse": [
            "Gate an agent tool input-schema upgrade for backward acceptance",
            "Get concrete evidence for a breaking schema change"
          ],
          "whenNotToUse": [
            "General JSON Schema subsumption",
            "Deciding behavior compatibility or security from schemas alone"
          ],
          "capabilities": [
            "Conservative three-state result with verified counterexamples",
            "128 schema nodes, 12 schema levels, 64 properties, 50,000 evaluations"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "schemaNodes": 128,
            "schemaDepth": 12,
            "schemaProperties": 64,
            "evaluations": 50000,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "previous": {
                    "$ref": "#/paths/~1v1~1mpp~1json-schema-compatibility/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "next": {
                    "$ref": "#/paths/~1v1~1mpp~1json-schema-compatibility/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "previous",
                  "next"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-schema-compatibility/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-schema-compatibility/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "previous": {
                  "type": "object",
                  "required": [
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "integer",
                      "minimum": 1
                    }
                  },
                  "additionalProperties": false
                },
                "next": {
                  "type": "object",
                  "required": [
                    "id"
                  ],
                  "properties": {
                    "id": {
                      "type": "number",
                      "minimum": 0
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-schema-compatibility",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "typed-schema-subset-v1"
                        },
                        "direction": {
                          "type": "string",
                          "const": "previous-values-accepted-by-next"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "compatible",
                            "incompatible",
                            "unknown"
                          ]
                        },
                        "reason": {
                          "type": "string"
                        },
                        "counterexample": {
                          "$ref": "#/paths/~1v1~1mpp~1json-schema-compatibility/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "suggestion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "suggestion"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "direction",
                        "status",
                        "reason",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-schema-compatibility/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-schema-compatibility/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-schema-compatibility",
                  "version": "0.29.0",
                  "result": {
                    "profile": "typed-schema-subset-v1",
                    "direction": "previous-values-accepted-by-next",
                    "status": "compatible",
                    "reason": "Structural inclusion is proven within the supported typed-schema subset",
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "dd27f1605af650c8b48ed4422054aaed98c3bc8afa80c4533f79b96fdc2e4b31",
                    "outputSha256": "e02b5cd7e5d59488f52186284375a3d78ab30aca31037483aebc2767711f5b4a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-schema-to-tool": {
      "post": {
        "operationId": "mpp_json_schema_to_tool",
        "summary": "JSON Schema to MCP Tool Descriptor",
        "description": "Wrap a supported object-root JSON Schema in a deterministic MCP tool descriptor, optionally with an object-root output schema. Rejects unsupported keywords instead of silently weakening constraints. Does not deploy a tool, execute code, or claim provider-specific strict function compatibility.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-schema-to-tool.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Create a named MCP tool descriptor from an object input schema",
            "Adapt a bounded JSON object schema into a tool definition",
            "Preserve schema constraints during tool registration preparation"
          ],
          "whenToUse": [
            "Create a named MCP tool descriptor from an object input schema",
            "Adapt a bounded JSON object schema into a tool definition",
            "Preserve schema constraints during tool registration preparation"
          ],
          "whenNotToUse": [
            "OpenAI strict-mode conversion or arbitrary JSON Schema conversion",
            "Installing or running an MCP server"
          ],
          "capabilities": [
            "No lossy keyword removal or execution",
            "OBJECT_SCHEMA_REQUIRED and UNSUPPORTED_SCHEMA errors"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "schemaNodes": 128,
            "schemaDepth": 12,
            "schemaProperties": 64,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128,
                    "pattern": "^[A-Za-z0-9_.-]+$"
                  },
                  "description": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2048
                  },
                  "inputSchema": {
                    "$ref": "#/paths/~1v1~1mpp~1json-schema-to-tool/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "outputSchema": {
                    "$ref": "#/paths/~1v1~1mpp~1json-schema-to-tool/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "name",
                  "description",
                  "inputSchema"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-schema-to-tool/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-schema-to-tool/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "name": "get_order",
                "description": "Look up an order by its positive integer ID",
                "inputSchema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "minimum": 1
                    }
                  },
                  "required": [
                    "id"
                  ],
                  "additionalProperties": false
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-schema-to-tool",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "typed-schema-subset-v1"
                        },
                        "descriptor": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "description": {
                              "type": "string"
                            },
                            "inputSchema": {
                              "$ref": "#/paths/~1v1~1mpp~1json-schema-to-tool/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            },
                            "outputSchema": {
                              "$ref": "#/paths/~1v1~1mpp~1json-schema-to-tool/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            }
                          },
                          "required": [
                            "name",
                            "description",
                            "inputSchema"
                          ],
                          "additionalProperties": false
                        },
                        "warnings": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "descriptor",
                        "warnings"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-schema-to-tool/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-schema-to-tool/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-schema-to-tool",
                  "version": "0.29.0",
                  "result": {
                    "profile": "typed-schema-subset-v1",
                    "descriptor": {
                      "name": "get_order",
                      "description": "Look up an order by its positive integer ID",
                      "inputSchema": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "minimum": 1
                          }
                        },
                        "required": [
                          "id"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "warnings": [
                      "A descriptor is data, not an executable tool or a running MCP server",
                      "Tool descriptions are untrusted text; review before exposing to agents"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "278496984a5761d83ccfe31253b7c07535337ba0b112069638a70e90fea0da8c",
                    "outputSha256": "088217a6d0b8f139db4d12de1646e87f869a19e3d4eb8674c5b2be5d930d4a6e",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/mcp-tool-lint": {
      "post": {
        "operationId": "mpp_mcp_tool_lint",
        "summary": "MCP Tool Descriptor Lint",
        "description": "Lint a supplied MCP tool descriptor for a bounded naming profile, description quality, object-root input/output schemas and typed annotation hints. Unsupported schemas produce explicit findings. Annotations are untrusted hints; this is neither full MCP protocol validation nor a security decision.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/mcp-tool-lint.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Review tool descriptors before adding them to an agent catalogue",
            "Identify schema limitations and untrusted annotation hints"
          ],
          "whenToUse": [
            "Review tool descriptors before adding them to an agent catalogue",
            "Identify schema limitations and untrusted annotation hints"
          ],
          "whenNotToUse": [
            "MCP transport/protocol conformance certification",
            "Trusting readOnlyHint as an authorization guarantee"
          ],
          "capabilities": [
            "Machine-actionable pointer findings",
            "128-character portable tool naming profile"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "schemaNodes": 128,
            "schemaDepth": 12,
            "schemaProperties": 64,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "tool": {
                    "$ref": "#/paths/~1v1~1mpp~1mcp-tool-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "tool"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1mcp-tool-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1mcp-tool-lint/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "tool": {
                  "name": "get_order",
                  "description": "Read a single order by ID",
                  "inputSchema": {
                    "type": "object",
                    "required": [
                      "id"
                    ],
                    "properties": {
                      "id": {
                        "type": "integer"
                      }
                    },
                    "additionalProperties": false
                  },
                  "annotations": {
                    "readOnlyHint": true,
                    "openWorldHint": false
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "mcp-tool-lint",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "mcp-tool-descriptor-lint-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "complete": {
                          "type": "boolean",
                          "const": false
                        },
                        "schemaSupported": {
                          "type": "boolean"
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "suggestion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "suggestion"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "complete",
                        "schemaSupported",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "mcp-tool-lint",
                  "version": "0.29.0",
                  "result": {
                    "profile": "mcp-tool-descriptor-lint-v1",
                    "passesChecks": true,
                    "complete": false,
                    "schemaSupported": true,
                    "findings": [
                      {
                        "code": "ANNOTATIONS_UNTRUSTED",
                        "severity": "warning",
                        "path": "/tool/annotations",
                        "message": "Annotations are hints and cannot establish authorization or safety",
                        "suggestion": "Verify tool behavior and enforce permissions independently"
                      }
                    ],
                    "findingCount": 1,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "f66182b11adf2e7a4e3a849f0df9edd8d3045eae4ccea501d2b2e9a7d491f31c",
                    "outputSha256": "6c4e2538aeec9993abca6cba4ccddc9e47a5a1a7f2e4836c55d4ff5380d13ce2",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/openapi-request-check": {
      "post": {
        "operationId": "mpp_openapi_request_check",
        "summary": "OpenAPI Request Preflight",
        "description": "Check already-deserialized supplied parameter values and an optional JSON body against one exact OpenAPI 3.1 path-template/method. Applies the typed-schema subset only; references, serialization, authentication, parameter content and non-JSON bodies are not evaluated. Reports unsupported coverage separately from invalid values; never sends the request.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/openapi-request-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Preflight a typed API request before paying for or executing it",
            "Find missing required parameters and incompatible JSON bodies"
          ],
          "whenToUse": [
            "Preflight a typed API request before paying for or executing it",
            "Find missing required parameters and incompatible JSON bodies"
          ],
          "whenNotToUse": [
            "Validating raw URL encoding, serialization, auth or live behavior",
            "Resolving OpenAPI references or arbitrary JSON Schema"
          ],
          "capabilities": [
            "Exact method and path-template selection",
            "Case-insensitive supplied headers; no coercion; unsupported coverage yields valid null"
          ],
          "limits": {
            "inputBytes": 110000,
            "jsonNodes": 10000,
            "depth": 24,
            "paths": 100,
            "operations": 200,
            "effectiveParameters": 100,
            "schemaNodes": 128,
            "schemaDepth": 12,
            "schemaProperties": 64,
            "evaluations": 50000,
            "findings": 200,
            "outputBytes": 450000,
            "jsonPointerCharacters": 4096
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SCHEMA_LIMIT",
            "EVALUATION_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "POINTER_LIMIT",
            "UNSUPPORTED_OPENAPI",
            "INVALID_OPENAPI",
            "OPENAPI_LIMIT",
            "UNSUPPORTED_SCHEMA",
            "OBJECT_SCHEMA_REQUIRED",
            "OPERATION_NOT_FOUND"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1mpp~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "path": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "get",
                      "put",
                      "post",
                      "delete",
                      "options",
                      "head",
                      "patch",
                      "trace"
                    ]
                  },
                  "parameters": {
                    "default": {},
                    "type": "object",
                    "properties": {
                      "path": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "query": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "header": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "cookie": {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    },
                    "additionalProperties": false
                  },
                  "body": {
                    "$ref": "#/paths/~1v1~1mpp~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "document",
                  "path",
                  "method"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-request-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "openapi": "3.1.0",
                  "info": {
                    "title": "Orders",
                    "version": "1.0.0"
                  },
                  "paths": {
                    "/orders/{id}": {
                      "get": {
                        "operationId": "getOrder",
                        "summary": "Read one order",
                        "parameters": [
                          {
                            "name": "id",
                            "in": "path",
                            "required": true,
                            "schema": {
                              "type": "integer",
                              "minimum": 1
                            }
                          }
                        ],
                        "responses": {
                          "200": {
                            "description": "Order"
                          }
                        }
                      }
                    }
                  }
                },
                "path": "/orders/{id}",
                "method": "get",
                "parameters": {
                  "path": {
                    "id": 7
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "openapi-request-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "openapi-deserialized-request-subset-v1"
                        },
                        "supported": {
                          "type": "boolean"
                        },
                        "valid": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "checkedValues": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "suggestion": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "suggestion"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "supported",
                        "valid",
                        "checkedValues",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "openapi-request-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "openapi-deserialized-request-subset-v1",
                    "supported": true,
                    "valid": true,
                    "checkedValues": 1,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "7c5e745808fc3f1d280011987900f177671819c8881581432eb3a5a0654de254",
                    "outputSha256": "28f2aa7115986471ad8bcbdf90d6db4708b426b1eccf2ac7658678e89cdf3280",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/package-url-inspect": {
      "post": {
        "operationId": "mpp_package_url_inspect",
        "summary": "Package URL Inspect",
        "description": "Parse a bounded Package URL and normalize generic syntax: type/qualifier case, percent encoding, qualifier order. Preserves name/version case; no ecosystem rules or registry validation. Strict subset rejects empty/dot path segments, whitespace, raw reserved characters, malformed UTF-8, and duplicate qualifiers.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/package-url-inspect.md"
        },
        "x-agent-discovery": {
          "intents": [
            "parse package URL",
            "normalize PURL syntax",
            "inspect package coordinates"
          ],
          "whenToUse": [
            "Extract package type, namespace, version, qualifiers, and subpath without network access",
            "Normalize percent escapes and qualifier ordering inside the advertised subset"
          ],
          "whenNotToUse": [
            "Full ECMA-427 or ecosystem-specific PURL validation/canonicalization",
            "Registry existence checks or fetching package artifacts"
          ],
          "capabilities": [
            "Generic syntax profile with explicit ecosystemRulesApplied=false",
            "Sorted unique qualifier keys; UTF-8 decoding; no fetch"
          ],
          "related": [
            "sbom-inventory",
            "sbom-diff"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "purlCharacters": 4096,
            "namespaceSegments": 32,
            "qualifiers": 32,
            "subpathSegments": 32
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "INVALID_PURL"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "purl": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4096
                  }
                },
                "required": [
                  "purl"
                ],
                "additionalProperties": false
              },
              "example": {
                "purl": "pkg:npm/%40acme/worker-kit@1.2.0?repository_url=https%3A%2F%2Fregistry.example&arch=x64#dist/index.js"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "package-url-inspect",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "normalized": {
                          "type": "string",
                          "maxLength": 12288
                        },
                        "type": {
                          "type": "string",
                          "maxLength": 100
                        },
                        "namespace": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 2048
                          }
                        },
                        "name": {
                          "type": "string",
                          "maxLength": 2048
                        },
                        "version": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 2048
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "qualifiers": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 2048
                              }
                            },
                            "required": [
                              "key",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "subpath": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 2048
                          }
                        },
                        "profile": {
                          "type": "string",
                          "const": "generic-syntax-subset-v1"
                        },
                        "ecosystemRulesApplied": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "normalized",
                        "type",
                        "namespace",
                        "name",
                        "version",
                        "qualifiers",
                        "subpath",
                        "profile",
                        "ecosystemRulesApplied"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "package-url-inspect",
                  "version": "0.29.0",
                  "result": {
                    "normalized": "pkg:npm/%40acme/worker-kit@1.2.0?arch=x64&repository_url=https%3A%2F%2Fregistry.example#dist/index.js",
                    "type": "npm",
                    "namespace": [
                      "@acme"
                    ],
                    "name": "worker-kit",
                    "version": "1.2.0",
                    "qualifiers": [
                      {
                        "key": "arch",
                        "value": "x64"
                      },
                      {
                        "key": "repository_url",
                        "value": "https://registry.example"
                      }
                    ],
                    "subpath": [
                      "dist",
                      "index.js"
                    ],
                    "profile": "generic-syntax-subset-v1",
                    "ecosystemRulesApplied": false
                  },
                  "provenance": {
                    "inputSha256": "5c4dfe4d67dbd3df697be9f5119fee7da589fd2f05cf0bf7ea10c6b860c04659",
                    "outputSha256": "99448916979697e5c9fff32ebdecee9d452e113f95e03134503022f51e86aca1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/sbom-inventory": {
      "post": {
        "operationId": "mpp_sbom_inventory",
        "summary": "SBOM Inventory",
        "description": "Extract names, versions, PURLs, declared licenses and hashes from CycloneDX JSON 1.5/1.6 or SPDX JSON 2.3. Includes nested CycloneDX components and metadata.component; excludes services, external BOMs, relationships and unconsumed fields. No full document, license, PURL or hash validation.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/sbom-inventory.md"
        },
        "x-agent-discovery": {
          "intents": [
            "extract SBOM inventory",
            "extract component names, versions and licenses from a software bill of materials",
            "read CycloneDX components",
            "read SPDX packages"
          ],
          "whenToUse": [
            "Build a small auditable component inventory from caller-supplied SBOM JSON",
            "Retain source JSON pointers and distinguish declared/concluded license fields"
          ],
          "whenNotToUse": [
            "Full SBOM conformance checks, dependency resolution or vulnerability scanning",
            "XML/tag-value inputs, external document traversal or artifact verification"
          ],
          "capabilities": [
            "CycloneDX 1.5 and 1.6 JSON, SPDX 2.3 JSON",
            "Nested components, metadata root, normalized license/hash lists and source pointers",
            "Unknown fields ignored; consumed fields strictly type-checked"
          ],
          "related": [
            "sbom-diff",
            "package-url-inspect",
            "spdx-expression-analyze"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "components": 500,
            "licensesPerComponent": 16,
            "hashesPerComponent": 16,
            "spdxExternalRefsPerPackage": 64
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "INVALID_DOCUMENT",
            "UNSUPPORTED_SBOM",
            "AMBIGUOUS_COMPONENT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {},
                    "description": "JSON document: at most 100,000 UTF-8 serialized bytes per request, 12,000 nodes and 24 levels; consumed fields are type-checked; unconsumed fields are ignored, not standards-validated."
                  }
                },
                "required": [
                  "document"
                ],
                "additionalProperties": false
              },
              "example": {
                "document": {
                  "bomFormat": "CycloneDX",
                  "specVersion": "1.6",
                  "components": [
                    {
                      "type": "library",
                      "name": "worker-kit",
                      "version": "1.2.0",
                      "purl": "pkg:npm/worker-kit@1.2.0",
                      "licenses": [
                        {
                          "license": {
                            "id": "MIT"
                          }
                        }
                      ]
                    }
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "sbom-inventory",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "format": {
                          "type": "string",
                          "enum": [
                            "CycloneDX",
                            "SPDX"
                          ]
                        },
                        "specVersion": {
                          "type": "string",
                          "enum": [
                            "1.5",
                            "1.6",
                            "2.3"
                          ]
                        },
                        "componentCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 500
                        },
                        "components": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "sourcePointer": {
                                "type": "string",
                                "maxLength": 4096
                              },
                              "reference": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string",
                                "maxLength": 2048
                              },
                              "group": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "version": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "purl": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 4096
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "type": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "licenses": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "enum": [
                                        "id",
                                        "name",
                                        "expression",
                                        "declared",
                                        "concluded"
                                      ]
                                    },
                                    "value": {
                                      "type": "string",
                                      "maxLength": 2048
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "hashes": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "algorithm": {
                                      "type": "string",
                                      "maxLength": 100
                                    },
                                    "value": {
                                      "type": "string",
                                      "maxLength": 2048
                                    }
                                  },
                                  "required": [
                                    "algorithm",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "sourcePointer",
                              "reference",
                              "name",
                              "group",
                              "version",
                              "purl",
                              "type",
                              "licenses",
                              "hashes"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "scope": {
                          "type": "string",
                          "const": "Extracted fields only; not full SBOM validation, dependency resolution, vulnerability scanning, or license compliance advice."
                        }
                      },
                      "required": [
                        "format",
                        "specVersion",
                        "componentCount",
                        "components",
                        "scope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "sbom-inventory",
                  "version": "0.29.0",
                  "result": {
                    "format": "CycloneDX",
                    "specVersion": "1.6",
                    "componentCount": 1,
                    "components": [
                      {
                        "sourcePointer": "/components/0",
                        "reference": null,
                        "name": "worker-kit",
                        "group": null,
                        "version": "1.2.0",
                        "purl": "pkg:npm/worker-kit@1.2.0",
                        "type": "library",
                        "licenses": [
                          {
                            "kind": "id",
                            "value": "MIT"
                          }
                        ],
                        "hashes": []
                      }
                    ],
                    "scope": "Extracted fields only; not full SBOM validation, dependency resolution, vulnerability scanning, or license compliance advice."
                  },
                  "provenance": {
                    "inputSha256": "80931d8b46b2cd7402b3eb7dedc67a8372ac5684a142e1ebfa31493d5b89c3fc",
                    "outputSha256": "7e9c092e6244e94d15ec23a34c2caa1ee002055ee1038c47c42ec09cd231c2b7",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/sbom-diff": {
      "post": {
        "operationId": "mpp_sbom_diff",
        "summary": "SBOM Diff",
        "description": "Compare two supported SBOMs by unique exact group/name (default) or versionless generic-PURL identity. Report added/removed components and version/license/hash/PURL/type changes. Duplicate identities are rejected rather than cross-paired. Reference IDs and source positions are ignored; license comparison is textual, not semantic.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/sbom-diff.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compare SBOM releases",
            "compare software bills of materials for added, removed and changed components",
            "detect component version changes",
            "review declared license changes"
          ],
          "whenToUse": [
            "Review deterministic component changes between two caller-supplied SBOMs",
            "Reject ambiguous duplicates instead of inventing version matches"
          ],
          "whenNotToUse": [
            "License equivalence, transitive graph impact or vulnerability analysis",
            "Inventing matches across renamed packages, ecosystems or duplicate identities"
          ],
          "capabilities": [
            "Name/group or versionless PURL matching",
            "Stable sorted change reports; bounded map lookup rather than pairwise joins",
            "Cross-format comparisons preserve declared versus concluded license distinctions"
          ],
          "related": [
            "sbom-inventory",
            "package-url-inspect",
            "dependency-risk-flags"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "componentsPerDocument": 500,
            "inputBytesSharedAcrossBothDocuments": 100000
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "INVALID_DOCUMENT",
            "UNSUPPORTED_SBOM",
            "AMBIGUOUS_COMPONENT",
            "MISSING_PURL",
            "INVALID_PURL"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "before": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {},
                    "description": "JSON document: at most 100,000 UTF-8 serialized bytes per request, 12,000 nodes and 24 levels; consumed fields are type-checked; unconsumed fields are ignored, not standards-validated."
                  },
                  "after": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {},
                    "description": "JSON document: at most 100,000 UTF-8 serialized bytes per request, 12,000 nodes and 24 levels; consumed fields are type-checked; unconsumed fields are ignored, not standards-validated."
                  },
                  "matchBy": {
                    "default": "name",
                    "type": "string",
                    "enum": [
                      "name",
                      "purl"
                    ]
                  }
                },
                "required": [
                  "before",
                  "after"
                ],
                "additionalProperties": false
              },
              "example": {
                "before": {
                  "bomFormat": "CycloneDX",
                  "specVersion": "1.6",
                  "components": [
                    {
                      "type": "library",
                      "name": "worker-kit",
                      "version": "1.2.0",
                      "purl": "pkg:npm/worker-kit@1.2.0",
                      "licenses": [
                        {
                          "license": {
                            "id": "MIT"
                          }
                        }
                      ]
                    }
                  ]
                },
                "after": {
                  "bomFormat": "CycloneDX",
                  "specVersion": "1.6",
                  "components": [
                    {
                      "type": "library",
                      "name": "worker-kit",
                      "version": "1.3.0",
                      "purl": "pkg:npm/worker-kit@1.3.0",
                      "licenses": [
                        {
                          "license": {
                            "id": "MIT"
                          }
                        }
                      ]
                    }
                  ]
                },
                "matchBy": "name"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "sbom-diff",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "matchBy": {
                          "type": "string",
                          "enum": [
                            "name",
                            "purl"
                          ]
                        },
                        "added": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "identity": {
                                "type": "string",
                                "maxLength": 12288
                              },
                              "component": {
                                "type": "object",
                                "properties": {
                                  "sourcePointer": {
                                    "type": "string",
                                    "maxLength": 4096
                                  },
                                  "reference": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "group": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "version": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "purl": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 4096
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "type": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "licenses": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "id",
                                            "name",
                                            "expression",
                                            "declared",
                                            "concluded"
                                          ]
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  "hashes": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "algorithm": {
                                          "type": "string",
                                          "maxLength": 100
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "algorithm",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "sourcePointer",
                                  "reference",
                                  "name",
                                  "group",
                                  "version",
                                  "purl",
                                  "type",
                                  "licenses",
                                  "hashes"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "identity",
                              "component"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "removed": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "identity": {
                                "type": "string",
                                "maxLength": 12288
                              },
                              "component": {
                                "type": "object",
                                "properties": {
                                  "sourcePointer": {
                                    "type": "string",
                                    "maxLength": 4096
                                  },
                                  "reference": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "group": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "version": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "purl": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 4096
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "type": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "licenses": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "id",
                                            "name",
                                            "expression",
                                            "declared",
                                            "concluded"
                                          ]
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  "hashes": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "algorithm": {
                                          "type": "string",
                                          "maxLength": 100
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "algorithm",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "sourcePointer",
                                  "reference",
                                  "name",
                                  "group",
                                  "version",
                                  "purl",
                                  "type",
                                  "licenses",
                                  "hashes"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "identity",
                              "component"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "changed": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "identity": {
                                "type": "string",
                                "maxLength": 12288
                              },
                              "fields": {
                                "maxItems": 5,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "version",
                                    "licenses",
                                    "hashes",
                                    "purl",
                                    "type"
                                  ]
                                }
                              },
                              "before": {
                                "type": "object",
                                "properties": {
                                  "sourcePointer": {
                                    "type": "string",
                                    "maxLength": 4096
                                  },
                                  "reference": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "group": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "version": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "purl": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 4096
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "type": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "licenses": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "id",
                                            "name",
                                            "expression",
                                            "declared",
                                            "concluded"
                                          ]
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  "hashes": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "algorithm": {
                                          "type": "string",
                                          "maxLength": 100
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "algorithm",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "sourcePointer",
                                  "reference",
                                  "name",
                                  "group",
                                  "version",
                                  "purl",
                                  "type",
                                  "licenses",
                                  "hashes"
                                ],
                                "additionalProperties": false
                              },
                              "after": {
                                "type": "object",
                                "properties": {
                                  "sourcePointer": {
                                    "type": "string",
                                    "maxLength": 4096
                                  },
                                  "reference": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "name": {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  "group": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "version": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "purl": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 4096
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "type": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 2048
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "licenses": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "id",
                                            "name",
                                            "expression",
                                            "declared",
                                            "concluded"
                                          ]
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  "hashes": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "algorithm": {
                                          "type": "string",
                                          "maxLength": 100
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 2048
                                        }
                                      },
                                      "required": [
                                        "algorithm",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "sourcePointer",
                                  "reference",
                                  "name",
                                  "group",
                                  "version",
                                  "purl",
                                  "type",
                                  "licenses",
                                  "hashes"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "identity",
                              "fields",
                              "before",
                              "after"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "unchangedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 500
                        },
                        "scope": {
                          "type": "string",
                          "const": "Unique group/name or versionless generic-PURL identities only; reference IDs, ordering, and source positions are ignored. Duplicate identities are rejected, not guessed."
                        }
                      },
                      "required": [
                        "matchBy",
                        "added",
                        "removed",
                        "changed",
                        "unchangedCount",
                        "scope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "sbom-diff",
                  "version": "0.29.0",
                  "result": {
                    "matchBy": "name",
                    "added": [],
                    "removed": [],
                    "changed": [
                      {
                        "identity": "[null,\"worker-kit\"]",
                        "fields": [
                          "version",
                          "purl"
                        ],
                        "before": {
                          "sourcePointer": "/components/0",
                          "reference": null,
                          "name": "worker-kit",
                          "group": null,
                          "version": "1.2.0",
                          "purl": "pkg:npm/worker-kit@1.2.0",
                          "type": "library",
                          "licenses": [
                            {
                              "kind": "id",
                              "value": "MIT"
                            }
                          ],
                          "hashes": []
                        },
                        "after": {
                          "sourcePointer": "/components/0",
                          "reference": null,
                          "name": "worker-kit",
                          "group": null,
                          "version": "1.3.0",
                          "purl": "pkg:npm/worker-kit@1.3.0",
                          "type": "library",
                          "licenses": [
                            {
                              "kind": "id",
                              "value": "MIT"
                            }
                          ],
                          "hashes": []
                        }
                      }
                    ],
                    "unchangedCount": 0,
                    "scope": "Unique group/name or versionless generic-PURL identities only; reference IDs, ordering, and source positions are ignored. Duplicate identities are rejected, not guessed."
                  },
                  "provenance": {
                    "inputSha256": "b19944d599f94ec8f81c15402bd893787a4e4bbb2eb0f5ae646264db8b31b8b2",
                    "outputSha256": "d267cc8407c56c634f70b48cbbdd55534cbeb8ea0c293a8e92a61b1b9e3e31d6",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/lockfile-inventory": {
      "post": {
        "operationId": "mpp_lockfile_inventory",
        "summary": "Lockfile Inventory",
        "description": "Extract npm package-lock v2/v3 packages by sorted location, retaining versions, resolved sources, integrity/license strings and dev/optional/devOptional/link/install-script flags. No package installation, graph resolution or hash verification. Workspace names require a declared name; node_modules names can be inferred from location.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/lockfile-inventory.md"
        },
        "x-agent-discovery": {
          "intents": [
            "inventory npm lockfile",
            "extract package-lock dependencies",
            "inspect lockfile integrity metadata"
          ],
          "whenToUse": [
            "Read package locations and declared metadata without installing anything",
            "Retain nested copies and workspace links as separate locations"
          ],
          "whenNotToUse": [
            "npm v1, Yarn, pnpm, Poetry or Cargo lockfiles",
            "Transitive dependency graph resolution, artifact retrieval or installation verification"
          ],
          "capabilities": [
            "npm package-lock v2/v3 packages table",
            "Explicit root toggle; sorted location rows; false for omitted boolean flags",
            "Links reported without following targets; legacy dependencies table ignored"
          ],
          "related": [
            "dependency-risk-flags",
            "sbom-inventory"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "packageLocationsIncludingRoot": 500,
            "locationCharacters": 1024
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "INVALID_DOCUMENT",
            "UNSUPPORTED_LOCKFILE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {},
                    "description": "JSON document: at most 100,000 UTF-8 serialized bytes per request, 12,000 nodes and 24 levels; consumed fields are type-checked; unconsumed fields are ignored, not standards-validated."
                  },
                  "includeRoot": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "document"
                ],
                "additionalProperties": false
              },
              "example": {
                "document": {
                  "name": "edge-worker",
                  "lockfileVersion": 3,
                  "packages": {
                    "": {
                      "name": "edge-worker",
                      "version": "1.0.0"
                    },
                    "node_modules/worker-kit": {
                      "version": "1.2.0",
                      "resolved": "https://registry.example/worker-kit-1.2.0.tgz",
                      "license": "MIT",
                      "dev": true
                    }
                  }
                },
                "includeRoot": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "lockfile-inventory",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "lockfileVersion": {
                          "anyOf": [
                            {
                              "type": "number",
                              "const": 2
                            },
                            {
                              "type": "number",
                              "const": 3
                            }
                          ]
                        },
                        "packageCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 500
                        },
                        "packages": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "location": {
                                "type": "string",
                                "maxLength": 1024
                              },
                              "name": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "version": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "resolved": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "integrity": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "license": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 2048
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "dev": {
                                "type": "boolean"
                              },
                              "optional": {
                                "type": "boolean"
                              },
                              "devOptional": {
                                "type": "boolean"
                              },
                              "link": {
                                "type": "boolean"
                              },
                              "inBundle": {
                                "type": "boolean"
                              },
                              "hasInstallScript": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "location",
                              "name",
                              "version",
                              "resolved",
                              "integrity",
                              "license",
                              "dev",
                              "optional",
                              "devOptional",
                              "link",
                              "inBundle",
                              "hasInstallScript"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "scope": {
                          "type": "string",
                          "const": "npm package-lock v2/v3 packages table only; legacy dependencies ignored; absent boolean flags are false; link targets are not followed and hashes are not verified."
                        }
                      },
                      "required": [
                        "lockfileVersion",
                        "packageCount",
                        "packages",
                        "scope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "lockfile-inventory",
                  "version": "0.29.0",
                  "result": {
                    "lockfileVersion": 3,
                    "packageCount": 1,
                    "packages": [
                      {
                        "location": "node_modules/worker-kit",
                        "name": "worker-kit",
                        "version": "1.2.0",
                        "resolved": "https://registry.example/worker-kit-1.2.0.tgz",
                        "integrity": null,
                        "license": "MIT",
                        "dev": true,
                        "optional": false,
                        "devOptional": false,
                        "link": false,
                        "inBundle": false,
                        "hasInstallScript": false
                      }
                    ],
                    "scope": "npm package-lock v2/v3 packages table only; legacy dependencies ignored; absent boolean flags are false; link targets are not followed and hashes are not verified."
                  },
                  "provenance": {
                    "inputSha256": "44372e18b4f1fb63575b3659833ee08607dc747c5e42deb3df735da0985fee80",
                    "outputSha256": "b0104ed8c8a474575b7c231e15b166b1022bb87eb42a3f8e18782794e5e86b31",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/dependency-risk-flags": {
      "post": {
        "operationId": "mpp_dependency_risk_flags",
        "summary": "Dependency Metadata Flags",
        "description": "Flag declared npm-style metadata gaps: missing/non-exact canonical SemVer pins, missing/insecure/local/unrecognized sources, missing/malformed or SHA1-only integrity, and missing license markers. Syntax/presence heuristics only; no vulnerability database, artifact verification, trust score or legal conclusion.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/dependency-risk-flags.md"
        },
        "x-agent-discovery": {
          "intents": [
            "flag dependency metadata gaps",
            "find unpinned npm specifiers",
            "check declared integrity syntax"
          ],
          "whenToUse": [
            "Triage a bounded declared dependency list before human policy review",
            "Find missing pins, source declarations, integrity strings and license metadata"
          ],
          "whenNotToUse": [
            "Vulnerability or malware scanning, security certification, license compatibility decisions",
            "Treating absent flags as evidence a dependency is safe or authentic"
          ],
          "capabilities": [
            "Canonical SemVer exact-pin check; ranges, tags and git pins flagged as non-exact SemVer",
            "Canonical padded base64 SRI subset: SHA1/SHA256/SHA384/SHA512, at most 16 digests",
            "No fetch, hash verification, registry query or aggregate risk score"
          ],
          "related": [
            "lockfile-inventory",
            "spdx-expression-analyze",
            "semver-evaluate"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "dependencies": 500,
            "specifierCharacters": 256,
            "integrityDigests": 16
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "dependencies": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 256
                        },
                        "specifier": {
                          "type": "string",
                          "maxLength": 256
                        },
                        "source": {
                          "type": "string",
                          "maxLength": 2048
                        },
                        "integrity": {
                          "type": "string",
                          "maxLength": 2048
                        },
                        "license": {
                          "type": "string",
                          "maxLength": 2048
                        }
                      },
                      "required": [
                        "name"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "dependencies"
                ],
                "additionalProperties": false
              },
              "example": {
                "dependencies": [
                  {
                    "name": "worker-kit",
                    "specifier": "^1.2.0",
                    "source": "http://registry.example/worker-kit.tgz",
                    "license": "NOASSERTION"
                  },
                  {
                    "name": "private-plugin",
                    "specifier": "2.0.0",
                    "source": "file:../private-plugin",
                    "license": "UNLICENSED"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "dependency-risk-flags",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "dependencyCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 500
                        },
                        "flaggedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 500
                        },
                        "dependencies": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 499
                              },
                              "name": {
                                "type": "string",
                                "maxLength": 256
                              },
                              "flags": {
                                "maxItems": 11,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "MISSING_SPECIFIER",
                                    "NON_EXACT_SEMVER",
                                    "MISSING_SOURCE",
                                    "INSECURE_SOURCE",
                                    "LOCAL_SOURCE",
                                    "UNRECOGNIZED_SOURCE",
                                    "MISSING_INTEGRITY",
                                    "MALFORMED_INTEGRITY",
                                    "SHA1_INTEGRITY_ONLY",
                                    "MISSING_LICENSE",
                                    "LICENSE_MARKER"
                                  ]
                                }
                              }
                            },
                            "required": [
                              "index",
                              "name",
                              "flags"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "scope": {
                          "type": "string",
                          "const": "Declared npm-style metadata checks only. Exact pin means canonical SemVer; integrity is syntax-checked, never verified against bytes. Flags are not vulnerabilities, trust scores, license advice, or security certification."
                        }
                      },
                      "required": [
                        "dependencyCount",
                        "flaggedCount",
                        "dependencies",
                        "scope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "dependency-risk-flags",
                  "version": "0.29.0",
                  "result": {
                    "dependencyCount": 2,
                    "flaggedCount": 2,
                    "dependencies": [
                      {
                        "index": 0,
                        "name": "worker-kit",
                        "flags": [
                          "NON_EXACT_SEMVER",
                          "INSECURE_SOURCE",
                          "MISSING_INTEGRITY",
                          "MISSING_LICENSE"
                        ]
                      },
                      {
                        "index": 1,
                        "name": "private-plugin",
                        "flags": [
                          "LOCAL_SOURCE",
                          "MISSING_INTEGRITY",
                          "LICENSE_MARKER"
                        ]
                      }
                    ],
                    "scope": "Declared npm-style metadata checks only. Exact pin means canonical SemVer; integrity is syntax-checked, never verified against bytes. Flags are not vulnerabilities, trust scores, license advice, or security certification."
                  },
                  "provenance": {
                    "inputSha256": "be895ca312990c168698ad23c01ab6760d8418b98486095625f41e3878f83b5e",
                    "outputSha256": "e688f33b9caae1165e9f447518bd5bf579033cb1748934c640d652ee9080234b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/spdx-expression-analyze": {
      "post": {
        "operationId": "mpp_spdx_expression_analyze",
        "summary": "SPDX Expression Analyze",
        "description": "Parse bounded SPDX-style license expression syntax into a flat indexed AST, unique identifiers/exceptions and fully parenthesized normalization. Supports AND/OR/WITH, +, LicenseRef and DocumentRef; enforces precedence and simple-left WITH. Does not validate current license/exception lists or give compliance advice; NONE/NOASSERTION document markers are rejected.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/spdx-expression-analyze.md"
        },
        "x-agent-discovery": {
          "intents": [
            "parse SPDX license expression",
            "inspect license expression AST",
            "normalize SPDX expression syntax"
          ],
          "whenToUse": [
            "Inspect operator precedence and identifier references in a supplied expression",
            "Perform bounded syntax preparation before a separate policy or license-list check"
          ],
          "whenNotToUse": [
            "Proving identifiers are in the current SPDX list",
            "License compatibility, legal advice or boolean expansion of all license choices"
          ],
          "capabilities": [
            "WITH before AND before OR; case-sensitive operators",
            "Flat postorder indexed AST avoids recursive output amplification",
            "ASCII spaces/tabs only; plus attaches directly to a non-reference identifier"
          ],
          "related": [
            "sbom-inventory",
            "dependency-risk-flags"
          ],
          "limits": {
            "inputBytes": 100000,
            "jsonNodes": 12000,
            "jsonDepth": 24,
            "outputBytes": 300000,
            "expressionCharacters": 4096,
            "tokens": 255,
            "astNodes": 255,
            "parenthesisLevels": 16
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "OUTPUT_LIMIT",
            "INVALID_SPDX_EXPRESSION"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "expression": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4096
                  }
                },
                "required": [
                  "expression"
                ],
                "additionalProperties": false
              },
              "example": {
                "expression": "MIT OR Apache-2.0 AND GPL-2.0-only WITH Classpath-exception-2.0"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "spdx-expression-analyze",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "syntaxValid": {
                          "type": "boolean",
                          "const": true
                        },
                        "normalized": {
                          "type": "string",
                          "maxLength": 8192
                        },
                        "root": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 254
                        },
                        "nodes": {
                          "minItems": 1,
                          "maxItems": 255,
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "license"
                                  },
                                  "identifier": {
                                    "type": "string",
                                    "maxLength": 256
                                  },
                                  "orLater": {
                                    "type": "boolean"
                                  },
                                  "customReference": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "kind",
                                  "identifier",
                                  "orLater",
                                  "customReference"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "const": "with"
                                  },
                                  "license": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 254
                                  },
                                  "exception": {
                                    "type": "string",
                                    "maxLength": 128
                                  }
                                },
                                "required": [
                                  "kind",
                                  "license",
                                  "exception"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "kind": {
                                    "type": "string",
                                    "enum": [
                                      "and",
                                      "or"
                                    ]
                                  },
                                  "left": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 254
                                  },
                                  "right": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 254
                                  }
                                },
                                "required": [
                                  "kind",
                                  "left",
                                  "right"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        },
                        "licenseIdentifiers": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 256
                          }
                        },
                        "exceptions": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 128
                          }
                        },
                        "scope": {
                          "type": "string",
                          "const": "SPDX 2.3 expression grammar subset with ASCII spaces/tabs, case-sensitive operators, LicenseRef and optional DocumentRef. Identifiers are not checked against a current SPDX list; no legal or compatibility conclusions."
                        }
                      },
                      "required": [
                        "syntaxValid",
                        "normalized",
                        "root",
                        "nodes",
                        "licenseIdentifiers",
                        "exceptions",
                        "scope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "spdx-expression-analyze",
                  "version": "0.29.0",
                  "result": {
                    "syntaxValid": true,
                    "normalized": "(MIT OR (Apache-2.0 AND GPL-2.0-only WITH Classpath-exception-2.0))",
                    "root": 5,
                    "nodes": [
                      {
                        "kind": "license",
                        "identifier": "MIT",
                        "orLater": false,
                        "customReference": false
                      },
                      {
                        "kind": "license",
                        "identifier": "Apache-2.0",
                        "orLater": false,
                        "customReference": false
                      },
                      {
                        "kind": "license",
                        "identifier": "GPL-2.0-only",
                        "orLater": false,
                        "customReference": false
                      },
                      {
                        "kind": "with",
                        "license": 2,
                        "exception": "Classpath-exception-2.0"
                      },
                      {
                        "kind": "and",
                        "left": 1,
                        "right": 3
                      },
                      {
                        "kind": "or",
                        "left": 0,
                        "right": 4
                      }
                    ],
                    "licenseIdentifiers": [
                      "Apache-2.0",
                      "GPL-2.0-only",
                      "MIT"
                    ],
                    "exceptions": [
                      "Classpath-exception-2.0"
                    ],
                    "scope": "SPDX 2.3 expression grammar subset with ASCII spaces/tabs, case-sensitive operators, LicenseRef and optional DocumentRef. Identifiers are not checked against a current SPDX list; no legal or compatibility conclusions."
                  },
                  "provenance": {
                    "inputSha256": "2d769c525513182591de214bb176bf06aed5e0544a40aa706ec0920311cca573",
                    "outputSha256": "32c66e480aa54016a4e908e59960671718f6afa5c0f95e16ae75ac708b083cd2",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/workflow-dag-analyze": {
      "post": {
        "operationId": "mpp_workflow_dag_analyze",
        "summary": "Workflow Dependency Analysis",
        "description": "Find missing dependencies and cyclic components; derive stable parallel layers, critical path, earliest/latest timings and slack from a supplied task graph. Caller-estimated integer durations and unlimited parallel workers only; never executes tasks.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/workflow-dag-analyze.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find cycles and missing dependencies in an agent task DAG",
            "Plan parallel execution stages and estimate a workflow critical path"
          ],
          "whenToUse": [
            "Find cycles and missing dependencies in an agent task DAG",
            "Plan parallel execution stages and estimate a workflow critical path"
          ],
          "whenNotToUse": [
            "Resource-constrained scheduling or runtime prediction guarantees",
            "Executing, authorizing, or monitoring agent work"
          ],
          "capabilities": [
            "Actual cyclic components separated from blocked downstream tasks",
            "Stable topological layers and critical-path slack"
          ],
          "related": [
            "workflow-transition-check",
            "retry-schedule-plan"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "tasks": 100,
            "dependencyEdges": 1000,
            "durationMsPerTask": 86400000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "tasks": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "dependsOn": {
                          "default": [],
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 80
                          }
                        },
                        "durationMs": {
                          "default": 0,
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 86400000
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "tasks"
                ],
                "additionalProperties": false
              },
              "example": {
                "tasks": [
                  {
                    "id": "fetch",
                    "durationMs": 100
                  },
                  {
                    "id": "summarize",
                    "dependsOn": [
                      "fetch"
                    ],
                    "durationMs": 300
                  },
                  {
                    "id": "index",
                    "dependsOn": [
                      "fetch"
                    ],
                    "durationMs": 200
                  },
                  {
                    "id": "publish",
                    "dependsOn": [
                      "summarize",
                      "index"
                    ],
                    "durationMs": 50
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "workflow-dag-analyze",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "workflow-dag-v1"
                        },
                        "schedulable": {
                          "type": "boolean"
                        },
                        "topologicalOrder": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "layers": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "cycles": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        },
                        "unresolvedTaskIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "criticalPath": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "makespanMs": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "timing": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "earliestStartMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "earliestFinishMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "latestStartMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "slackMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "id",
                              "earliestStartMs",
                              "earliestFinishMs",
                              "latestStartMs",
                              "slackMs"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "assumptions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "schedulable",
                        "topologicalOrder",
                        "layers",
                        "cycles",
                        "unresolvedTaskIds",
                        "criticalPath",
                        "makespanMs",
                        "timing",
                        "assumptions",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "workflow-dag-analyze",
                  "version": "0.29.0",
                  "result": {
                    "profile": "workflow-dag-v1",
                    "schedulable": true,
                    "topologicalOrder": [
                      "fetch",
                      "index",
                      "summarize",
                      "publish"
                    ],
                    "layers": [
                      [
                        "fetch"
                      ],
                      [
                        "index",
                        "summarize"
                      ],
                      [
                        "publish"
                      ]
                    ],
                    "cycles": [],
                    "unresolvedTaskIds": [],
                    "criticalPath": [
                      "fetch",
                      "summarize",
                      "publish"
                    ],
                    "makespanMs": 450,
                    "timing": [
                      {
                        "id": "fetch",
                        "earliestStartMs": 0,
                        "earliestFinishMs": 100,
                        "latestStartMs": 0,
                        "slackMs": 0
                      },
                      {
                        "id": "index",
                        "earliestStartMs": 100,
                        "earliestFinishMs": 300,
                        "latestStartMs": 200,
                        "slackMs": 100
                      },
                      {
                        "id": "publish",
                        "earliestStartMs": 400,
                        "earliestFinishMs": 450,
                        "latestStartMs": 400,
                        "slackMs": 0
                      },
                      {
                        "id": "summarize",
                        "earliestStartMs": 100,
                        "earliestFinishMs": 400,
                        "latestStartMs": 100,
                        "slackMs": 0
                      }
                    ],
                    "assumptions": [
                      "Durations are caller estimates in integer milliseconds",
                      "Unlimited parallel workers; no resource, retry, or network-time model"
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "654c113aff490cf72c0ff1c9957cfdfa5f2471cd0437e341e58f2eb81483c0fc",
                    "outputSha256": "4079a937ef3a0f4766cb2c0b1319139fc1cb87d4c90150b9a422db21b9e53df9",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/workflow-transition-check": {
      "post": {
        "operationId": "mpp_workflow_transition_check",
        "summary": "Workflow State Trace Check",
        "description": "Validate a declared deterministic state machine and replay a supplied event trace. Reports ambiguous transitions, unreachable states, first impossible event, expected-state mismatches and final acceptance. No executable guards, actions, or authorization decisions.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/workflow-transition-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Audit an agent workflow event trace against allowed state transitions",
            "Find impossible transitions and incomplete terminal workflow states"
          ],
          "whenToUse": [
            "Audit an agent workflow event trace against allowed state transitions",
            "Find impossible transitions and incomplete terminal workflow states"
          ],
          "whenNotToUse": [
            "Formal verification of arbitrary programs or hidden state",
            "Interpreting natural-language policy or granting real-world permissions"
          ],
          "capabilities": [
            "Stops derivation at the first undefined transition",
            "Accepting-state checks and exact trace evidence"
          ],
          "related": [
            "workflow-dag-analyze",
            "jsonrpc-exchange-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "states": 100,
            "transitions": 500,
            "events": 500
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "states": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    }
                  },
                  "initialState": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80
                  },
                  "acceptingStates": {
                    "default": [],
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    }
                  },
                  "requireAccepting": {
                    "default": false,
                    "type": "boolean"
                  },
                  "transitions": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "from": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "event": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "to": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "from",
                        "event",
                        "to"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "events": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "event": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "expectedState": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "event"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "states",
                  "initialState",
                  "transitions",
                  "events"
                ],
                "additionalProperties": false
              },
              "example": {
                "states": [
                  "new",
                  "running",
                  "done"
                ],
                "initialState": "new",
                "acceptingStates": [
                  "done"
                ],
                "requireAccepting": true,
                "transitions": [
                  {
                    "from": "new",
                    "event": "start",
                    "to": "running"
                  },
                  {
                    "from": "running",
                    "event": "finish",
                    "to": "done"
                  }
                ],
                "events": [
                  {
                    "event": "start"
                  },
                  {
                    "event": "finish",
                    "expectedState": "done"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "workflow-transition-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "workflow-transition-v1"
                        },
                        "configurationValid": {
                          "type": "boolean"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "processedEvents": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "finalState": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "isAccepting": {
                          "type": "boolean"
                        },
                        "stoppedAt": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "unreachableStates": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "trace": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "event": {
                                "type": "string"
                              },
                              "from": {
                                "type": "string"
                              },
                              "to": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "index",
                              "event",
                              "from",
                              "to"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "configurationValid",
                        "passesChecks",
                        "processedEvents",
                        "finalState",
                        "isAccepting",
                        "stoppedAt",
                        "unreachableStates",
                        "trace",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "workflow-transition-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "workflow-transition-v1",
                    "configurationValid": true,
                    "passesChecks": true,
                    "processedEvents": 2,
                    "finalState": "done",
                    "isAccepting": true,
                    "stoppedAt": null,
                    "unreachableStates": [],
                    "trace": [
                      {
                        "index": 0,
                        "event": "start",
                        "from": "new",
                        "to": "running"
                      },
                      {
                        "index": 1,
                        "event": "finish",
                        "from": "running",
                        "to": "done"
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "31eb750355e55cbaa44cb491322c180f31ad4b141413227b57eac317027ffeca",
                    "outputSha256": "f35efb4f59d5483ad60b139bb108988686bf0090aeb91a3297754c4152753879",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/jsonrpc-exchange-check": {
      "post": {
        "operationId": "mpp_jsonrpc_exchange_check",
        "summary": "JSON-RPC Exchange Check",
        "description": "Inspect supplied parsed JSON-RPC 2.0 requests/responses for envelope errors, notification replies, typed-ID collisions, missing responses and unmatched results. Bounded safe-integer-ID correlation profile; no transport, method execution, schema validation, or full interoperability certification.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/jsonrpc-exchange-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Correlate JSON-RPC batch replies with agent tool requests",
            "Detect missing tool responses, duplicate request IDs and replies to notifications"
          ],
          "whenToUse": [
            "Correlate JSON-RPC batch replies with agent tool requests",
            "Detect missing tool responses, duplicate request IDs and replies to notifications"
          ],
          "whenNotToUse": [
            "MCP lifecycle/authentication verification or tool invocation",
            "Raw JSON syntax validation or fractional/unsafe numeric ID correlation"
          ],
          "capabilities": [
            "String and numeric IDs remain distinct",
            "JSON-RPC source: https://www.jsonrpc.org/specification"
          ],
          "related": [
            "mcp-tool-lint",
            "workflow-transition-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "requestEnvelopes": 200,
            "responseEnvelopes": 200
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "request": {
                    "$ref": "#/paths/~1v1~1mpp~1jsonrpc-exchange-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "response": {
                    "$ref": "#/paths/~1v1~1mpp~1jsonrpc-exchange-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "request"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1jsonrpc-exchange-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1jsonrpc-exchange-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "request": [
                  {
                    "jsonrpc": "2.0",
                    "method": "tools/list",
                    "id": "list-1"
                  },
                  {
                    "jsonrpc": "2.0",
                    "method": "notifications/initialized"
                  }
                ],
                "response": [
                  {
                    "jsonrpc": "2.0",
                    "id": "list-1",
                    "result": {
                      "tools": []
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "jsonrpc-exchange-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "jsonrpc-2-exchange-subset-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "complete": {
                          "type": "boolean",
                          "const": false
                        },
                        "requestCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "callCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "notificationCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matchedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matches": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "requestIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "responseIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "id": {
                                "type": [
                                  "string",
                                  "number",
                                  "null"
                                ]
                              },
                              "outcome": {
                                "type": "string",
                                "enum": [
                                  "result",
                                  "error"
                                ]
                              }
                            },
                            "required": [
                              "requestIndex",
                              "responseIndex",
                              "id",
                              "outcome"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "complete",
                        "requestCount",
                        "callCount",
                        "notificationCount",
                        "matchedCount",
                        "matches",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "jsonrpc-exchange-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "jsonrpc-2-exchange-subset-v1",
                    "passesChecks": true,
                    "complete": false,
                    "requestCount": 2,
                    "callCount": 1,
                    "notificationCount": 1,
                    "matchedCount": 1,
                    "matches": [
                      {
                        "requestIndex": 0,
                        "responseIndex": 0,
                        "id": "list-1",
                        "outcome": "result"
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "742afe870cf4c120f98c5b0fff5f0ed903299e18a9f053017e72ed4bfe73ac7d",
                    "outputSha256": "fc52f2b84c59159cb31402bfee7967089b41d95a0cbd5be8dd3a4feb7f7ff15e",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/evidence-quote-check": {
      "post": {
        "operationId": "mpp_evidence_quote_check",
        "summary": "Literal Quote Evidence Check",
        "description": "Check exact quotations against supplied source text, including optional UTF-16 start offsets. Returns source SHA-256 fingerprints, occurrence counts, bounded offsets and ambiguity/mismatch findings. Unique scans are capped at 4 million characters and 200,000 located occurrences. Establishes literal correspondence only, never truth, entailment, authenticity or source credibility.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/evidence-quote-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Verify agent-generated quotations against supplied source passages",
            "Locate exact quote offsets and detect ambiguous repeated evidence"
          ],
          "whenToUse": [
            "Verify agent-generated quotations against supplied source passages",
            "Locate exact quote offsets and detect ambiguous repeated evidence"
          ],
          "whenNotToUse": [
            "Fact checking, semantic support, paraphrase matching or source authenticity",
            "Fetching cited URLs or verifying unseen documents"
          ],
          "capabilities": [
            "Exact UTF-16 offsets with source UTF-8 SHA-256",
            "Unique source/literal scans cached; overlapping occurrences counted with a 200,000 aggregate occurrence cap; first 20 locations retained"
          ],
          "related": [
            "citation-coverage-audit",
            "context-budget-pack"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "sources": 100,
            "quotes": 200,
            "matchesPerQuote": 20
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "sources": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "quotes": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "sourceId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "text": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 10000
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        }
                      },
                      "required": [
                        "id",
                        "sourceId",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "sources",
                  "quotes"
                ],
                "additionalProperties": false
              },
              "example": {
                "sources": [
                  {
                    "id": "memo",
                    "text": "Launch requires two approvals. Launch date is pending."
                  }
                ],
                "quotes": [
                  {
                    "id": "q1",
                    "sourceId": "memo",
                    "text": "two approvals",
                    "start": 16
                  },
                  {
                    "id": "q2",
                    "sourceId": "memo",
                    "text": "Launch"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "evidence-quote-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "literal-quote-v1"
                        },
                        "allVerified": {
                          "type": "boolean"
                        },
                        "verifiesTruth": {
                          "type": "boolean",
                          "const": false
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16-code-units"
                        },
                        "sources": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "length": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "sha256Utf8": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "length",
                              "sha256Utf8"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "quotes": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "sourceId": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "verified",
                                  "ambiguous",
                                  "not_found",
                                  "location_mismatch",
                                  "source_missing"
                                ]
                              },
                              "occurrenceCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "matches": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "start": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "end": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "start",
                                    "end"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "matchesTruncated": {
                                "type": "boolean"
                              },
                              "requestedStart": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "sourceId",
                              "status",
                              "occurrenceCount",
                              "matches",
                              "matchesTruncated",
                              "requestedStart"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "allVerified",
                        "verifiesTruth",
                        "offsetUnit",
                        "sources",
                        "quotes"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "evidence-quote-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "literal-quote-v1",
                    "allVerified": false,
                    "verifiesTruth": false,
                    "offsetUnit": "UTF-16-code-units",
                    "sources": [
                      {
                        "id": "memo",
                        "length": 54,
                        "sha256Utf8": "f2192aa3501f668ea10cf34d338c5dcab73f0b31644d991b2d7c5cb36d9d69f1"
                      }
                    ],
                    "quotes": [
                      {
                        "id": "q1",
                        "sourceId": "memo",
                        "status": "verified",
                        "occurrenceCount": 1,
                        "matches": [
                          {
                            "start": 16,
                            "end": 29
                          }
                        ],
                        "matchesTruncated": false,
                        "requestedStart": 16
                      },
                      {
                        "id": "q2",
                        "sourceId": "memo",
                        "status": "ambiguous",
                        "occurrenceCount": 2,
                        "matches": [
                          {
                            "start": 0,
                            "end": 6
                          },
                          {
                            "start": 31,
                            "end": 37
                          }
                        ],
                        "matchesTruncated": false,
                        "requestedStart": null
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "9a9594408841790142d74851b491359b5edd3f738300edc0f10a1df0538a28f6",
                    "outputSha256": "ee4c1d855a2c7f287bcfd522c0f153fa1b573ccbc242a4c0155326de5d98d957",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/citation-coverage-audit": {
      "post": {
        "operationId": "mpp_citation_coverage_audit",
        "summary": "Citation Coverage Audit",
        "description": "Audit an explicit claim-to-evidence-to-source map for missing required citations, orphan references, duplicate links and unused evidence. Coverage counts valid structural links only; caller declares which claims need citations. No claim extraction, truth scoring or semantic entailment assessment.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/citation-coverage-audit.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Audit citation coverage of an agent report with explicit claim IDs",
            "Find orphan evidence references and unsupported-by-links required claims"
          ],
          "whenToUse": [
            "Audit citation coverage of an agent report with explicit claim IDs",
            "Find orphan evidence references and unsupported-by-links required claims"
          ],
          "whenNotToUse": [
            "Deciding whether evidence proves a claim",
            "Automatically extracting every factual claim from prose"
          ],
          "capabilities": [
            "Claim-level evidence/source edges and uncited IDs",
            "Zero required claims yields null coverage rather than a fabricated score"
          ],
          "related": [
            "evidence-quote-check",
            "context-budget-pack"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "sources": 100,
            "claims": 200,
            "evidence": 200,
            "citations": 500
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "sourceIds": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    }
                  },
                  "claims": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "requiresCitation": {
                          "default": true,
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "evidence": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "sourceId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "id",
                        "sourceId"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "citations": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "claimId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "evidenceId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "claimId",
                        "evidenceId"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "sourceIds",
                  "claims",
                  "evidence",
                  "citations"
                ],
                "additionalProperties": false
              },
              "example": {
                "sourceIds": [
                  "memo"
                ],
                "claims": [
                  {
                    "id": "approval-rule"
                  },
                  {
                    "id": "launch-date"
                  }
                ],
                "evidence": [
                  {
                    "id": "quote-1",
                    "sourceId": "memo"
                  }
                ],
                "citations": [
                  {
                    "claimId": "approval-rule",
                    "evidenceId": "quote-1"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "citation-coverage-audit",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "citation-coverage-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "verifiesTruth": {
                          "type": "boolean",
                          "const": false
                        },
                        "requiredClaimCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "coveredRequiredClaimCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "coverageRatio": {
                          "anyOf": [
                            {
                              "type": "number",
                              "minimum": 0,
                              "maximum": 1
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "uncitedClaimIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "unusedEvidenceIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "claimCoverage": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "claimId": {
                                "type": "string"
                              },
                              "requiresCitation": {
                                "type": "boolean"
                              },
                              "evidenceIds": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "sourceIds": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "required": [
                              "claimId",
                              "requiresCitation",
                              "evidenceIds",
                              "sourceIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "verifiesTruth",
                        "requiredClaimCount",
                        "coveredRequiredClaimCount",
                        "coverageRatio",
                        "uncitedClaimIds",
                        "unusedEvidenceIds",
                        "claimCoverage",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "citation-coverage-audit",
                  "version": "0.29.0",
                  "result": {
                    "profile": "citation-coverage-v1",
                    "passesChecks": false,
                    "verifiesTruth": false,
                    "requiredClaimCount": 2,
                    "coveredRequiredClaimCount": 1,
                    "coverageRatio": 0.5,
                    "uncitedClaimIds": [
                      "launch-date"
                    ],
                    "unusedEvidenceIds": [],
                    "claimCoverage": [
                      {
                        "claimId": "approval-rule",
                        "requiresCitation": true,
                        "evidenceIds": [
                          "quote-1"
                        ],
                        "sourceIds": [
                          "memo"
                        ]
                      },
                      {
                        "claimId": "launch-date",
                        "requiresCitation": true,
                        "evidenceIds": [],
                        "sourceIds": []
                      }
                    ],
                    "findings": [
                      {
                        "code": "UNCITED_REQUIRED_CLAIM",
                        "severity": "error",
                        "path": "/claims",
                        "message": "Claim launch-date has no valid evidence-to-source link"
                      }
                    ],
                    "findingCount": 1,
                    "errorCount": 1,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "4f74ca06a726ee2f32a640ff4e79e8fb59ef6c5938e3969ca51faf7d42c4b282",
                    "outputSha256": "3c4d1e1e27ebfe0574ab37e53045fd333d94c31fcbf9f6a3469556cc1fc3f744",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/artifact-manifest-check": {
      "post": {
        "operationId": "mpp_artifact_manifest_check",
        "summary": "Supplied Artifact Manifest Check",
        "description": "Compare a supplied text-file manifest with supplied UTF-8 contents: byte sizes, SHA-256 digests, missing/extra/duplicate paths and bounded portable-path collisions. Does not read a filesystem, decode archives, trust an unsigned manifest or verify publisher identity.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/artifact-manifest-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Verify an agent artifact handoff against expected file hashes and sizes",
            "Detect missing files, duplicate paths and portable filename collisions"
          ],
          "whenToUse": [
            "Verify an agent artifact handoff against expected file hashes and sizes",
            "Detect missing files, duplicate paths and portable filename collisions"
          ],
          "whenNotToUse": [
            "Signature verification, malware detection or archive extraction",
            "Reading remote or local files, binary contents, or complete cross-platform filename validation"
          ],
          "capabilities": [
            "UTF-8 SHA-256 and byte-length comparison per entry",
            "Portable subset rejects traversal, controls, reserved names; NFC/ASCII-case collision signals"
          ],
          "related": [
            "content-digest",
            "evidence-quote-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "manifestEntries": 100,
            "files": 100,
            "pathCharacters": 512
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "manifest": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512
                        },
                        "sizeBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        }
                      },
                      "required": [
                        "path",
                        "sizeBytes",
                        "sha256"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "files": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 512
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "path",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "allowExtraFiles": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "manifest",
                  "files"
                ],
                "additionalProperties": false
              },
              "example": {
                "manifest": [
                  {
                    "path": "output.txt",
                    "sizeBytes": 5,
                    "sha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
                  }
                ],
                "files": [
                  {
                    "path": "output.txt",
                    "text": "hello"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "artifact-manifest-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "supplied-text-manifest-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "verifiedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "extraPaths": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "entries": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "verified",
                                  "missing",
                                  "ambiguous",
                                  "mismatch",
                                  "invalid_path"
                                ]
                              },
                              "expectedBytes": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "actualBytes": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "expectedSha256": {
                                "type": "string"
                              },
                              "actualSha256": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "path",
                              "status",
                              "expectedBytes",
                              "actualBytes",
                              "expectedSha256",
                              "actualSha256"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "verifiedCount",
                        "extraPaths",
                        "entries",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "artifact-manifest-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "supplied-text-manifest-v1",
                    "passesChecks": true,
                    "verifiedCount": 1,
                    "extraPaths": [],
                    "entries": [
                      {
                        "path": "output.txt",
                        "status": "verified",
                        "expectedBytes": 5,
                        "actualBytes": 5,
                        "expectedSha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
                        "actualSha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824"
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "6c419edcbce9b5dcecf7cbc7a8529adb101c74f45956a8021ad1d79a30ad154d",
                    "outputSha256": "cc6ef62785c4ab397fb42be4f1381cf8eb76fbc602deb58c6e21f87dd9c2297d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/retry-schedule-plan": {
      "post": {
        "operationId": "mpp_retry_schedule_plan",
        "summary": "Bounded Retry Schedule Plan",
        "description": "Produce a deterministic hypothetical retry wait plan from explicit replay-safety assertions, HTTP status, backoff limits and waiting budget. Supports delta-seconds/IMF-fixdate Retry-After with explicit reference time. Stops for payment uncertainty and unknown/unsafe replay; never sends requests or authorizes repayment.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/retry-schedule-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Calculate capped retry backoff under a fixed waiting budget",
            "Respect Retry-After without clipping the server's minimum wait"
          ],
          "whenToUse": [
            "Calculate capped retry backoff under a fixed waiting budget",
            "Respect Retry-After without clipping the server's minimum wait"
          ],
          "whenNotToUse": [
            "Automatically retrying payment uncertainty or assuming idempotency",
            "Live scheduling, random jitter, traffic synchronization prevention, or complete HTTP-date parsing"
          ],
          "capabilities": [
            "Caller-established replay safety is mandatory",
            "Retry-After profile grounded in https://www.rfc-editor.org/rfc/rfc9110.html#name-retry-after"
          ],
          "related": [
            "workflow-dag-analyze",
            "workflow-transition-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "maxRetries": 10,
            "maxDelayMs": 3600000,
            "budgetMs": 86400000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "outcome": {
                    "type": "string",
                    "enum": [
                      "http-response",
                      "transport-uncertain",
                      "payment-uncertain"
                    ]
                  },
                  "replaySafety": {
                    "type": "string",
                    "enum": [
                      "safe",
                      "unsafe",
                      "unknown"
                    ]
                  },
                  "statusCode": {
                    "type": "integer",
                    "minimum": 100,
                    "maximum": 599
                  },
                  "retryAfter": {
                    "type": "string",
                    "maxLength": 128
                  },
                  "nowEpochMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4102444800000
                  },
                  "retryableStatuses": {
                    "default": [
                      408,
                      429,
                      500,
                      502,
                      503,
                      504
                    ],
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 100,
                      "maximum": 599
                    }
                  },
                  "maxRetries": {
                    "default": 3,
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "baseDelayMs": {
                    "default": 1000,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 60000
                  },
                  "multiplier": {
                    "default": 2,
                    "type": "number",
                    "minimum": 1,
                    "maximum": 10
                  },
                  "maxDelayMs": {
                    "default": 60000,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 3600000
                  },
                  "budgetMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 86400000
                  }
                },
                "required": [
                  "outcome",
                  "replaySafety",
                  "budgetMs"
                ],
                "additionalProperties": false
              },
              "example": {
                "outcome": "http-response",
                "replaySafety": "safe",
                "statusCode": 429,
                "retryAfter": "3",
                "maxRetries": 3,
                "baseDelayMs": 1000,
                "multiplier": 2,
                "maxDelayMs": 10000,
                "budgetMs": 10000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "retry-schedule-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "bounded-retry-plan-v1"
                        },
                        "eligible": {
                          "type": "boolean"
                        },
                        "reason": {
                          "type": "string",
                          "enum": [
                            "planned",
                            "payment_reconciliation_required",
                            "replay_safety_not_established",
                            "status_not_retryable",
                            "no_retries_requested",
                            "budget_exhausted",
                            "delay_limit_exceeded"
                          ]
                        },
                        "serverMinimumFirstDelayMs": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "plan": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "retry": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "delayMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "cumulativeDelayMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "retry",
                              "delayMs",
                              "cumulativeDelayMs"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "totalDelayMs": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "unplannedRetries": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "assumptions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "eligible",
                        "reason",
                        "serverMinimumFirstDelayMs",
                        "plan",
                        "totalDelayMs",
                        "unplannedRetries",
                        "assumptions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "retry-schedule-plan",
                  "version": "0.29.0",
                  "result": {
                    "profile": "bounded-retry-plan-v1",
                    "eligible": true,
                    "reason": "planned",
                    "serverMinimumFirstDelayMs": 3000,
                    "plan": [
                      {
                        "retry": 1,
                        "delayMs": 3000,
                        "cumulativeDelayMs": 3000
                      },
                      {
                        "retry": 2,
                        "delayMs": 2000,
                        "cumulativeDelayMs": 5000
                      },
                      {
                        "retry": 3,
                        "delayMs": 4000,
                        "cumulativeDelayMs": 9000
                      }
                    ],
                    "totalDelayMs": 9000,
                    "unplannedRetries": 0,
                    "assumptions": [
                      "Caller must establish replay safety; this plan grants no permission",
                      "No requests, payments, sleeps, or retries are executed",
                      "Hypothetical repeated failures; Retry-After applies only to the first retry",
                      "Budget counts waiting only; excludes execution time and has no jitter"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "a0d7ca9aaa8f91ec282225d6df1edc726e7034f4e317744fc540a2ba2ceef469",
                    "outputSha256": "d257e017c93ed0a51a5b49ecdf7bf20e7ca5190c89ad50c66ae46db72e17ada5",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/context-budget-pack": {
      "post": {
        "operationId": "mpp_context_budget_pack",
        "summary": "Evidence Context Budget Pack",
        "description": "Greedily select exact source spans by required status, priority and stable ID within caller-supplied integer cost units. Keeps provenance, rejects broken spans, protects required candidates and deduplicates optional identical text. Does not tokenize, summarize, infer semantic relevance, or guarantee an optimal packing.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/context-budget-pack.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Pack RAG evidence spans into a caller-defined context budget",
            "Keep mandatory excerpts while removing duplicate optional context"
          ],
          "whenToUse": [
            "Pack RAG evidence spans into a caller-defined context budget",
            "Keep mandatory excerpts while removing duplicate optional context"
          ],
          "whenNotToUse": [
            "Tokenizer-accurate model limits or semantic retrieval",
            "Optimal knapsack solutions or verifying caller-provided cost estimates"
          ],
          "capabilities": [
            "Exact source slices with UTF-16 provenance offsets",
            "Required set over budget returns no packed content and an explicit finding"
          ],
          "related": [
            "evidence-quote-check",
            "citation-coverage-audit",
            "text-chunk"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "quoteSearchCharacters": 4000000,
            "quoteOccurrenceEvaluations": 200000,
            "sources": 100,
            "candidates": 200,
            "budgetUnits": 1000000,
            "candidateSpanCharacters": 2000000,
            "packedTextJsonBytes": 200000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "EVALUATION_LIMIT",
            "INVALID_UNICODE",
            "INVALID_RETRY_AFTER",
            "INVALID_RETRY_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "sources": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "candidates": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "sourceId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "costUnits": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000
                        },
                        "priority": {
                          "default": 0,
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100
                        },
                        "required": {
                          "default": false,
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "id",
                        "sourceId",
                        "start",
                        "end",
                        "costUnits"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "budgetUnits": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "reservedUnits": {
                    "default": 0,
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "deduplicate": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "sources",
                  "candidates",
                  "budgetUnits"
                ],
                "additionalProperties": false
              },
              "example": {
                "sources": [
                  {
                    "id": "memo",
                    "text": "Approval is required. Timing remains tentative."
                  }
                ],
                "candidates": [
                  {
                    "id": "rule",
                    "sourceId": "memo",
                    "start": 0,
                    "end": 21,
                    "costUnits": 6,
                    "required": true
                  },
                  {
                    "id": "timing",
                    "sourceId": "memo",
                    "start": 22,
                    "end": 47,
                    "costUnits": 7,
                    "priority": 50
                  }
                ],
                "budgetUnits": 10,
                "reservedUnits": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "context-budget-pack",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "caller-cost-context-pack-v1"
                        },
                        "requiredSatisfied": {
                          "type": "boolean"
                        },
                        "withinBudget": {
                          "type": "boolean"
                        },
                        "usedUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "remainingUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16-code-units"
                        },
                        "selected": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "sourceId": {
                                "type": "string"
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "text": {
                                "type": "string"
                              },
                              "costUnits": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "priority": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "id",
                              "sourceId",
                              "start",
                              "end",
                              "text",
                              "costUnits",
                              "priority"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "excluded": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "reason": {
                                "type": "string",
                                "enum": [
                                  "invalid_span",
                                  "source_missing",
                                  "duplicate_text",
                                  "budget",
                                  "required_set_over_budget"
                                ]
                              },
                              "duplicateOf": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "reason",
                              "duplicateOf"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "requiredSatisfied",
                        "withinBudget",
                        "usedUnits",
                        "remainingUnits",
                        "offsetUnit",
                        "selected",
                        "excluded",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "context-budget-pack",
                  "version": "0.29.0",
                  "result": {
                    "profile": "caller-cost-context-pack-v1",
                    "requiredSatisfied": true,
                    "withinBudget": true,
                    "usedUnits": 8,
                    "remainingUnits": 2,
                    "offsetUnit": "UTF-16-code-units",
                    "selected": [
                      {
                        "id": "rule",
                        "sourceId": "memo",
                        "start": 0,
                        "end": 21,
                        "text": "Approval is required.",
                        "costUnits": 6,
                        "priority": 0
                      }
                    ],
                    "excluded": [
                      {
                        "id": "timing",
                        "reason": "budget",
                        "duplicateOf": null
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "27002969c140cfec802a9a9ff54a31c3c1a8973494991dfcd1646f7dd2adb7c2",
                    "outputSha256": "49b7a91bf4e79e98bdf9a81e0c3d6ab67a7d9b6fcf7e8f502c34771b2d1906a4",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/causal-log-check": {
      "post": {
        "operationId": "mpp_causal_log_check",
        "summary": "Causal event log check",
        "description": "Check a supplied multi-agent log against vector clocks, actor sequence continuity, baseline history and explicit parents; report unobserved dependencies and concurrent-clock pairs. Does not execute or authenticate history.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/causal-log-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Detect missing causal history in a multi-agent event log",
            "Check vector clock regressions and out-of-order agent messages before offline replay"
          ],
          "whenToUse": [
            "Detect missing causal history in a multi-agent event log",
            "Check vector clock regressions and out-of-order agent messages before offline replay"
          ],
          "whenNotToUse": [
            "Executing tools, sending messages, retrying effects, restoring state, or contacting live services",
            "Authenticating evidence, verifying signatures or identities, granting permission, or enforcing authorization",
            "Inferring facts omitted from the supplied artifact snapshot or guaranteeing exactly-once execution"
          ],
          "capabilities": [
            "causal-log-v1 profile",
            "Baseline continuation, per-actor counters and explicit parent clock dominance",
            "Missing inferred dependencies and bounded concurrent-clock evidence",
            "Advisory only; authorizationGranted=false; identityVerified=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "events": 256,
            "actors": 32,
            "traceSteps": 128,
            "observations": 256,
            "parentReferencesPerEvent": 32,
            "concurrentPairs": 64,
            "causalPairChecks": 32640
          },
          "related": [
            "replay-divergence-check",
            "checkpoint-handoff-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "ACTOR_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "baseline": {
                    "default": [],
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "actor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "counter": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "actor",
                        "counter"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "events": {
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "actor": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "sequence": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991
                        },
                        "parents": {
                          "default": [],
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "clock": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "actor": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "counter": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "actor",
                              "counter"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "actor",
                        "sequence",
                        "clock"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "events"
                ],
                "additionalProperties": false
              },
              "example": {
                "baseline": [],
                "events": [
                  {
                    "id": "a1",
                    "actor": "planner",
                    "sequence": 1,
                    "parents": [],
                    "clock": [
                      {
                        "actor": "planner",
                        "counter": 1
                      }
                    ]
                  },
                  {
                    "id": "b1",
                    "actor": "worker",
                    "sequence": 1,
                    "parents": [
                      "a1"
                    ],
                    "clock": [
                      {
                        "actor": "planner",
                        "counter": 1
                      },
                      {
                        "actor": "worker",
                        "counter": 1
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "causal-log-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "causal-log-v1"
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "eventCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "finalObservedClock": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "actor": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "counter": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "actor",
                              "counter"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "concurrentPairCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "concurrentPairs": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "left": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "right": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "required": [
                              "left",
                              "right"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "concurrentPairsTruncated": {
                          "type": "boolean"
                        },
                        "limitations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "consistent",
                        "advisoryOnly",
                        "eventCount",
                        "finalObservedClock",
                        "concurrentPairCount",
                        "concurrentPairs",
                        "concurrentPairsTruncated",
                        "limitations",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "causal-log-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "causal-log-v1",
                    "consistent": true,
                    "advisoryOnly": true,
                    "eventCount": 2,
                    "finalObservedClock": [
                      {
                        "actor": "planner",
                        "counter": 1
                      },
                      {
                        "actor": "worker",
                        "counter": 1
                      }
                    ],
                    "concurrentPairCount": 0,
                    "concurrentPairs": [],
                    "concurrentPairsTruncated": false,
                    "limitations": [
                      "Vector clocks and baseline are caller assertions, not authenticated history.",
                      "Input order must be a complete causal continuation of the baseline; explicit parents must be present even when covered by the baseline.",
                      "Concurrency describes supplied clock vectors and is not a conflict or a wall-clock ordering guarantee."
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "803aa46ee613401f0dc872cd13b8014258561eee5dba1dde1e0dd405af746fad",
                    "outputSha256": "8106034465bf192f701a91289769a3de196df7ea27fd5643c3441c058798035a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/replay-divergence-check": {
      "post": {
        "operationId": "mpp_replay_divergence_check",
        "summary": "Replay trace divergence check",
        "description": "Align two supplied execution traces by stable step ID, distinguish reordered/missing/extra steps and compare operation, canonical JSON requests, outcomes and result presence. Returns digest evidence without executing a replay.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/replay-divergence-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Locate deterministic replay divergence between recorded agent runs",
            "Compare step-level requests and outputs after a tool or prompt upgrade"
          ],
          "whenToUse": [
            "Locate deterministic replay divergence between recorded agent runs",
            "Compare step-level requests and outputs after a tool or prompt upgrade"
          ],
          "whenNotToUse": [
            "Executing tools, sending messages, retrying effects, restoring state, or contacting live services",
            "Authenticating evidence, verifying signatures or identities, granting permission, or enforcing authorization",
            "Inferring facts omitted from the supplied artifact snapshot or guaranteeing exactly-once execution"
          ],
          "capabilities": [
            "replay-divergence-v1 profile",
            "Stable-ID alignment, exact common-step order and matching prefix",
            "Presence-aware result hashes using sorted-json-sha256-v1",
            "Advisory only; authorizationGranted=false; identityVerified=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "events": 256,
            "actors": 32,
            "traceSteps": 128,
            "observations": 256,
            "stepsPerTrace": 128
          },
          "related": [
            "causal-log-check",
            "idempotency-conflict-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "ACTOR_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "baseline": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "operation": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "request": {
                          "$ref": "#/paths/~1v1~1mpp~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        },
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "success",
                            "error",
                            "unknown"
                          ]
                        },
                        "result": {
                          "$ref": "#/paths/~1v1~1mpp~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "required": [
                        "id",
                        "operation",
                        "request",
                        "outcome"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "candidate": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "operation": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "request": {
                          "$ref": "#/paths/~1v1~1mpp~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        },
                        "outcome": {
                          "type": "string",
                          "enum": [
                            "success",
                            "error",
                            "unknown"
                          ]
                        },
                        "result": {
                          "$ref": "#/paths/~1v1~1mpp~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "required": [
                        "id",
                        "operation",
                        "request",
                        "outcome"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "baseline",
                  "candidate"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1replay-divergence-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "baseline": [
                  {
                    "id": "step-1",
                    "operation": "extract",
                    "request": {
                      "text": "hello"
                    },
                    "outcome": "success",
                    "result": {
                      "count": 1
                    }
                  }
                ],
                "candidate": [
                  {
                    "id": "step-1",
                    "operation": "extract",
                    "request": {
                      "text": "hello"
                    },
                    "outcome": "success",
                    "result": {
                      "count": 2
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "replay-divergence-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "replay-divergence-v1"
                        },
                        "equivalent": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "digestProfile": {
                          "type": "string",
                          "const": "sorted-json-sha256-v1"
                        },
                        "matchingPrefixLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "commonStepCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "orderPreserved": {
                          "type": "boolean"
                        },
                        "firstDivergence": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "index": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "baselineId": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "candidateId": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "index",
                                "baselineId",
                                "candidateId"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "missingStepIds": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "extraStepIds": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "comparisons": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "baselineIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "candidateIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "sameOperation": {
                                "type": "boolean"
                              },
                              "sameRequest": {
                                "type": "boolean"
                              },
                              "sameOutcome": {
                                "type": "boolean"
                              },
                              "sameResult": {
                                "type": "boolean"
                              },
                              "baselineRequestSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "candidateRequestSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "baselineResultSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "candidateResultSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              }
                            },
                            "required": [
                              "id",
                              "baselineIndex",
                              "candidateIndex",
                              "sameOperation",
                              "sameRequest",
                              "sameOutcome",
                              "sameResult",
                              "baselineRequestSha256",
                              "candidateRequestSha256",
                              "baselineResultSha256",
                              "candidateResultSha256"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "limitations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "equivalent",
                        "advisoryOnly",
                        "digestProfile",
                        "matchingPrefixLength",
                        "commonStepCount",
                        "orderPreserved",
                        "firstDivergence",
                        "missingStepIds",
                        "extraStepIds",
                        "comparisons",
                        "limitations",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "replay-divergence-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "replay-divergence-v1",
                    "equivalent": false,
                    "advisoryOnly": true,
                    "digestProfile": "sorted-json-sha256-v1",
                    "matchingPrefixLength": 0,
                    "commonStepCount": 1,
                    "orderPreserved": true,
                    "firstDivergence": {
                      "index": 0,
                      "baselineId": "step-1",
                      "candidateId": "step-1"
                    },
                    "missingStepIds": [],
                    "extraStepIds": [],
                    "comparisons": [
                      {
                        "id": "step-1",
                        "baselineIndex": 0,
                        "candidateIndex": 0,
                        "sameOperation": true,
                        "sameRequest": true,
                        "sameOutcome": true,
                        "sameResult": false,
                        "baselineRequestSha256": "cbbbdcd27692344de5dbab3abcaba413fb0f45307267de7081401576df1cb176",
                        "candidateRequestSha256": "cbbbdcd27692344de5dbab3abcaba413fb0f45307267de7081401576df1cb176",
                        "baselineResultSha256": "dda59c1dd5dc7304423acc22eafddcb12e7550b4a1ac96525c6ea6eb8bcd5313",
                        "candidateResultSha256": "8ea34acc65cbbb9d9d54427c6a777d14668c7a6443bcdb56ad56fbfaf6de413e"
                      }
                    ],
                    "limitations": [
                      "Compares exact supplied JSON traces without executing or predicting a replay.",
                      "Step IDs must be unique within each trace; repeated attempts need distinct IDs.",
                      "Digest profile sorts keys by UTF-16 and uses JavaScript JSON numbers; it is not RFC 8785 or a signature. Result hashes include presence so absent differs from null.",
                      "Unknown outcomes and omitted effects cannot establish equivalent behavior outside these traces."
                    ],
                    "findings": [
                      {
                        "code": "RESULT_DIVERGED",
                        "severity": "error",
                        "path": "/candidate/0",
                        "message": "result differs from the aligned baseline step",
                        "relatedIds": [
                          "step-1"
                        ]
                      }
                    ],
                    "findingCount": 1,
                    "errorCount": 1,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "7053e487f5944c064974aeea44d3a57370d71b16669bb704de01deaedfce2fd7",
                    "outputSha256": "23ef080e8f51a0ad59ece5d5958fdc0221beed339139c5c8dd0c14465934f17e",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/idempotency-conflict-check": {
      "post": {
        "operationId": "mpp_idempotency_conflict_check",
        "summary": "Idempotency observation conflict check",
        "description": "Group supplied attempts by exact scope and idempotency key; find conflicting operation/request or success-result fingerprints and unresolved/stale pending outcomes. Advisory reconciliation only, never retry permission.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/idempotency-conflict-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find conflicting idempotency keys before retrying an uncertain agent tool call",
            "Triage duplicate success receipts and stale pending attempt logs"
          ],
          "whenToUse": [
            "Find conflicting idempotency keys before retrying an uncertain agent tool call",
            "Triage duplicate success receipts and stale pending attempt logs"
          ],
          "whenNotToUse": [
            "Executing tools, sending messages, retrying effects, restoring state, or contacting live services",
            "Authenticating evidence, verifying signatures or identities, granting permission, or enforcing authorization",
            "Inferring facts omitted from the supplied artifact snapshot or guaranteeing exactly-once execution"
          ],
          "capabilities": [
            "idempotency-conflict-v1 profile",
            "Exact (scope,key) grouping and operation/request fingerprints",
            "Conflicting successful responses and unresolved outcome review dispositions",
            "Advisory only; authorizationGranted=false; identityVerified=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "events": 256,
            "actors": 32,
            "traceSteps": 128,
            "observations": 256,
            "pendingTimeoutMaxMs": 604800000
          },
          "related": [
            "checkpoint-handoff-check",
            "retry-schedule-plan",
            "replay-divergence-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "ACTOR_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "asOfMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "pendingTimeoutMs": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 604800000
                  },
                  "observations": {
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "scope": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "key": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "operation": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "request": {
                          "$ref": "#/paths/~1v1~1mpp~1idempotency-conflict-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        },
                        "observedAtMs": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "pending",
                            "success",
                            "failure",
                            "unknown"
                          ]
                        },
                        "result": {
                          "$ref": "#/paths/~1v1~1mpp~1idempotency-conflict-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "required": [
                        "id",
                        "scope",
                        "key",
                        "operation",
                        "request",
                        "observedAtMs",
                        "status"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "asOfMs",
                  "pendingTimeoutMs",
                  "observations"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1idempotency-conflict-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1idempotency-conflict-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "asOfMs": 10000,
                "pendingTimeoutMs": 5000,
                "observations": [
                  {
                    "id": "attempt-1",
                    "scope": "orders:create",
                    "key": "job-42",
                    "operation": "create-order",
                    "request": {
                      "sku": "A",
                      "quantity": 1
                    },
                    "observedAtMs": 1000,
                    "status": "unknown"
                  },
                  {
                    "id": "attempt-2",
                    "scope": "orders:create",
                    "key": "job-42",
                    "operation": "create-order",
                    "request": {
                      "sku": "A",
                      "quantity": 2
                    },
                    "observedAtMs": 2000,
                    "status": "pending"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "idempotency-conflict-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "idempotency-conflict-v1"
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "digestProfile": {
                          "type": "string",
                          "const": "sorted-json-sha256-v1"
                        },
                        "groups": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "scope": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "key": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "observationIds": {
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              },
                              "requestSha256s": {
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[a-f0-9]{64}$"
                                }
                              },
                              "successfulResultSha256s": {
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[a-f0-9]{64}$"
                                }
                              },
                              "conflict": {
                                "type": "boolean"
                              },
                              "unknownOutcome": {
                                "type": "boolean"
                              },
                              "stalePending": {
                                "type": "boolean"
                              },
                              "disposition": {
                                "type": "string",
                                "enum": [
                                  "reconcile_conflict",
                                  "reconcile_unknown",
                                  "await_pending",
                                  "inspect_recorded_success",
                                  "inspect_failed_attempts"
                                ]
                              }
                            },
                            "required": [
                              "scope",
                              "key",
                              "observationIds",
                              "requestSha256s",
                              "successfulResultSha256s",
                              "conflict",
                              "unknownOutcome",
                              "stalePending",
                              "disposition"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "limitations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "consistent",
                        "advisoryOnly",
                        "digestProfile",
                        "groups",
                        "limitations",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "idempotency-conflict-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "idempotency-conflict-v1",
                    "consistent": false,
                    "advisoryOnly": true,
                    "digestProfile": "sorted-json-sha256-v1",
                    "groups": [
                      {
                        "scope": "orders:create",
                        "key": "job-42",
                        "observationIds": [
                          "attempt-1",
                          "attempt-2"
                        ],
                        "requestSha256s": [
                          "7488fe0cd2d6e45a4a0200317d4531f76a5eb754864f5c1b9198d9f23380e1e5",
                          "f9d1806b28d3a6f92838c9d28bb6fd8832fc04dc74668f7427e989973d65527d"
                        ],
                        "successfulResultSha256s": [],
                        "conflict": true,
                        "unknownOutcome": true,
                        "stalePending": true,
                        "disposition": "reconcile_conflict"
                      }
                    ],
                    "limitations": [
                      "The namespace is exactly (scope,key); provider retention windows and key-generation changes are not inferred.",
                      "No result authorizes a retry, proves that an effect occurred once, or checks a provider's live idempotency store.",
                      "Pending and unknown records remain unresolved even if another record reports success; caller reconciliation is required.",
                      "Request fingerprints cover operation and request. Successful-result hashes cover supplied JSON only and are not authenticated receipts."
                    ],
                    "findings": [
                      {
                        "code": "UNKNOWN_OUTCOME",
                        "severity": "warning",
                        "path": "/observations/0/status",
                        "message": "Reconcile provider evidence before considering another attempt",
                        "relatedIds": [
                          "attempt-1"
                        ]
                      },
                      {
                        "code": "STALE_PENDING",
                        "severity": "warning",
                        "path": "/observations/1",
                        "message": "Pending observation exceeded the supplied review timeout; this does not prove failure",
                        "relatedIds": [
                          "attempt-2"
                        ]
                      },
                      {
                        "code": "KEY_REQUEST_CONFLICT",
                        "severity": "error",
                        "path": "/observations/0/key",
                        "message": "The same scope and key were used for different operation/request fingerprints",
                        "relatedIds": [
                          "attempt-1",
                          "attempt-2"
                        ]
                      }
                    ],
                    "findingCount": 3,
                    "errorCount": 1,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "6eefc98b638cd666018d9da7909bff489df07808a56386ae3571e13cb517cc6b",
                    "outputSha256": "9574ce734c89446b01aa669ff3910e3a98b76f8b9c5612cd0484bce978afd441",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/approval-scope-check": {
      "post": {
        "operationId": "mpp_approval_scope_check",
        "summary": "Supplied approval scope comparison",
        "description": "Compare a structured caller-supplied approval receipt to a proposed action: exact actor and scope, declared data-class subset, payload digest, caller time window, revocation and use count. Does not authenticate or grant authorization.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/approval-scope-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Detect scope drift or expiry in an offline human-approval receipt",
            "Compare a proposed action with an exact structured approval artifact before human review"
          ],
          "whenToUse": [
            "Detect scope drift or expiry in an offline human-approval receipt",
            "Compare a proposed action with an exact structured approval artifact before human review"
          ],
          "whenNotToUse": [
            "Executing tools, sending messages, retrying effects, restoring state, or contacting live services",
            "Authenticating evidence, verifying signatures or identities, granting permission, or enforcing authorization",
            "Inferring facts omitted from the supplied artifact snapshot or guaranteeing exactly-once execution"
          ],
          "capabilities": [
            "approval-scope-v1 profile",
            "Exact scope and payload digest comparison with declared data-class subset",
            "Exclusive expiry and usage-count assertions; authorizationGranted=false and identityVerified=false",
            "Advisory only; authorizationGranted=false; identityVerified=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "events": 256,
            "actors": 32,
            "traceSteps": 128,
            "observations": 256,
            "dataClassesPerScope": 16,
            "scopeMatching": "exact case-sensitive strings; no wildcards"
          },
          "related": [
            "checkpoint-handoff-check",
            "json-canonicalize"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "ACTOR_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "asOfMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "approval": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "actor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "scope": {
                        "type": "object",
                        "properties": {
                          "operation": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "recipient": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "resource": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "purpose": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "dataClasses": {
                            "maxItems": 16,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            }
                          }
                        },
                        "required": [
                          "operation",
                          "recipient",
                          "resource",
                          "purpose",
                          "dataClasses"
                        ],
                        "additionalProperties": false
                      },
                      "payloadSha256": {
                        "type": "string",
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "issuedAtMs": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "expiresAtMs": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "revoked": {
                        "type": "boolean"
                      },
                      "maxUses": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      },
                      "priorUses": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000
                      }
                    },
                    "required": [
                      "id",
                      "actor",
                      "scope",
                      "payloadSha256",
                      "issuedAtMs",
                      "expiresAtMs",
                      "revoked",
                      "maxUses",
                      "priorUses"
                    ],
                    "additionalProperties": false
                  },
                  "proposal": {
                    "type": "object",
                    "properties": {
                      "actor": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "scope": {
                        "type": "object",
                        "properties": {
                          "operation": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "recipient": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "resource": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "purpose": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 200
                          },
                          "dataClasses": {
                            "maxItems": 16,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            }
                          }
                        },
                        "required": [
                          "operation",
                          "recipient",
                          "resource",
                          "purpose",
                          "dataClasses"
                        ],
                        "additionalProperties": false
                      },
                      "payload": {
                        "$ref": "#/paths/~1v1~1mpp~1approval-scope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    },
                    "required": [
                      "actor",
                      "scope",
                      "payload"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "asOfMs",
                  "approval",
                  "proposal"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1approval-scope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1approval-scope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "asOfMs": 100,
                "approval": {
                  "id": "approval-1",
                  "actor": "agent-1",
                  "scope": {
                    "operation": "send-note",
                    "recipient": "team@example.test",
                    "resource": "thread-1",
                    "purpose": "status-update",
                    "dataClasses": [
                      "business-contact"
                    ]
                  },
                  "payloadSha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                  "issuedAtMs": 0,
                  "expiresAtMs": 1000,
                  "revoked": false,
                  "maxUses": 1,
                  "priorUses": 0
                },
                "proposal": {
                  "actor": "agent-1",
                  "scope": {
                    "operation": "send-note",
                    "recipient": "team@example.test",
                    "resource": "thread-1",
                    "purpose": "status-update",
                    "dataClasses": [
                      "business-contact"
                    ]
                  },
                  "payload": {}
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "approval-scope-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "approval-scope-v1"
                        },
                        "matchesSuppliedApproval": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        },
                        "identityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "approvalId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "payloadSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "digestProfile": {
                          "type": "string",
                          "const": "sorted-json-sha256-v1"
                        },
                        "checks": {
                          "type": "object",
                          "properties": {
                            "actor": {
                              "type": "boolean"
                            },
                            "operation": {
                              "type": "boolean"
                            },
                            "recipient": {
                              "type": "boolean"
                            },
                            "resource": {
                              "type": "boolean"
                            },
                            "purpose": {
                              "type": "boolean"
                            },
                            "dataClasses": {
                              "type": "boolean"
                            },
                            "payload": {
                              "type": "boolean"
                            },
                            "timeWindow": {
                              "type": "boolean"
                            },
                            "notRevoked": {
                              "type": "boolean"
                            },
                            "usesRemaining": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "actor",
                            "operation",
                            "recipient",
                            "resource",
                            "purpose",
                            "dataClasses",
                            "payload",
                            "timeWindow",
                            "notRevoked",
                            "usesRemaining"
                          ],
                          "additionalProperties": false
                        },
                        "limitations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "matchesSuppliedApproval",
                        "advisoryOnly",
                        "authorizationGranted",
                        "identityVerified",
                        "approvalId",
                        "payloadSha256",
                        "digestProfile",
                        "checks",
                        "limitations",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "approval-scope-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "approval-scope-v1",
                    "matchesSuppliedApproval": true,
                    "advisoryOnly": true,
                    "authorizationGranted": false,
                    "identityVerified": false,
                    "approvalId": "approval-1",
                    "payloadSha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                    "digestProfile": "sorted-json-sha256-v1",
                    "checks": {
                      "actor": true,
                      "operation": true,
                      "recipient": true,
                      "resource": true,
                      "purpose": true,
                      "dataClasses": true,
                      "payload": true,
                      "timeWindow": true,
                      "notRevoked": true,
                      "usesRemaining": true
                    },
                    "limitations": [
                      "All approval, identity, revocation, usage and time inputs are unverified caller assertions.",
                      "This is an offline comparison and never grants or substitutes for required human approval or an authorization service.",
                      "Scope strings are exact and case-sensitive; no wildcards, URL equivalence, delegation, or implicit recipient expansion.",
                      "Proposal data classes must be a subset of the declared approved classes; their truth is not inferred from payload contents.",
                      "The payload digest uses the custom sorted-json-sha256-v1 profile, not a signature or general canonical JSON standard."
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "1dad1a8fc0a2aa96d0cc1216c1f6ba3500c4f2d51b51098c2ef5dba80d4ee048",
                    "outputSha256": "01cfe41c857b2418ca2e408aed082517f8dbfcfea2e59f557c77bfebd62c823a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/checkpoint-handoff-check": {
      "post": {
        "operationId": "mpp_checkpoint_handoff_check",
        "summary": "Checkpoint handoff consistency check",
        "description": "Compare a checkpoint with a proposed resume packet: workflow/consumer/revision, JSON state digest, required artifact manifests, exact stream cursors and pending-effect receipts. Reports reconciliation blockers; never restores or dispatches anything.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/checkpoint-handoff-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Check an agent checkpoint handoff before resuming after interruption",
            "Find missing artifacts, cursor gaps and uncertain side effects in a recovery packet"
          ],
          "whenToUse": [
            "Check an agent checkpoint handoff before resuming after interruption",
            "Find missing artifacts, cursor gaps and uncertain side effects in a recovery packet"
          ],
          "whenNotToUse": [
            "Executing tools, sending messages, retrying effects, restoring state, or contacting live services",
            "Authenticating evidence, verifying signatures or identities, granting permission, or enforcing authorization",
            "Inferring facts omitted from the supplied artifact snapshot or guaranteeing exactly-once execution"
          ],
          "capabilities": [
            "checkpoint-handoff-v1 profile",
            "State digest, required manifest and exact cursor cross-reference checks",
            "Prepared/submitted/acknowledged effect receipt reconciliation; authorizationGranted=false",
            "Advisory only; authorizationGranted=false; identityVerified=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "events": 256,
            "actors": 32,
            "traceSteps": 128,
            "observations": 256,
            "artifacts": 128,
            "cursors": 128,
            "effects": 128,
            "receipts": 128
          },
          "related": [
            "causal-log-check",
            "idempotency-conflict-check",
            "approval-scope-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "ACTOR_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "checkpoint": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "workflowId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "revision": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "consumer": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "createdAtMs": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "expiresAtMs": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "stateSha256": {
                        "type": "string",
                        "pattern": "^[a-f0-9]{64}$"
                      },
                      "artifacts": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "sha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            },
                            "required": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "id",
                            "sha256",
                            "required"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "cursors": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "stream": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "nextSequence": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "stream",
                            "nextSequence"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "effects": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "requestSha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            },
                            "phase": {
                              "type": "string",
                              "enum": [
                                "prepared",
                                "submitted",
                                "acknowledged"
                              ]
                            },
                            "receiptId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            }
                          },
                          "required": [
                            "id",
                            "requestSha256",
                            "phase"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "id",
                      "workflowId",
                      "revision",
                      "consumer",
                      "createdAtMs",
                      "expiresAtMs",
                      "stateSha256",
                      "artifacts",
                      "cursors",
                      "effects"
                    ],
                    "additionalProperties": false
                  },
                  "resume": {
                    "type": "object",
                    "properties": {
                      "workflowId": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "expectedRevision": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "consumer": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "asOfMs": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 9007199254740991
                      },
                      "state": {
                        "$ref": "#/paths/~1v1~1mpp~1checkpoint-handoff-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      },
                      "artifacts": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "sha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            }
                          },
                          "required": [
                            "id",
                            "sha256"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "cursors": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "stream": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "nextSequence": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "stream",
                            "nextSequence"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "receipts": {
                        "maxItems": 128,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "effectId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "requestSha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$"
                            },
                            "receiptId": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "outcome": {
                              "type": "string",
                              "enum": [
                                "success",
                                "failure"
                              ]
                            }
                          },
                          "required": [
                            "effectId",
                            "requestSha256",
                            "receiptId",
                            "outcome"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "workflowId",
                      "expectedRevision",
                      "consumer",
                      "asOfMs",
                      "state",
                      "artifacts",
                      "cursors",
                      "receipts"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "checkpoint",
                  "resume"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1checkpoint-handoff-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1checkpoint-handoff-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "checkpoint": {
                  "id": "checkpoint-1",
                  "workflowId": "workflow-1",
                  "revision": 3,
                  "consumer": "agent-b",
                  "createdAtMs": 0,
                  "expiresAtMs": 1000,
                  "stateSha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                  "artifacts": [
                    {
                      "id": "plan",
                      "sha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                      "required": true
                    }
                  ],
                  "cursors": [
                    {
                      "stream": "events",
                      "nextSequence": 4
                    }
                  ],
                  "effects": [
                    {
                      "id": "send-1",
                      "requestSha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                      "phase": "submitted"
                    }
                  ]
                },
                "resume": {
                  "workflowId": "workflow-1",
                  "expectedRevision": 3,
                  "consumer": "agent-b",
                  "asOfMs": 100,
                  "state": {},
                  "artifacts": [
                    {
                      "id": "plan",
                      "sha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a"
                    }
                  ],
                  "cursors": [
                    {
                      "stream": "events",
                      "nextSequence": 4
                    }
                  ],
                  "receipts": []
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "checkpoint-handoff-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "checkpoint-handoff-v1"
                        },
                        "matchesCheckpoint": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        },
                        "checkpointId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "stateSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "digestProfile": {
                          "type": "string",
                          "const": "sorted-json-sha256-v1"
                        },
                        "requiresEffectReconciliation": {
                          "type": "boolean"
                        },
                        "artifactChecks": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "required": {
                                "type": "boolean"
                              },
                              "present": {
                                "type": "boolean"
                              },
                              "digestMatches": {
                                "type": [
                                  "boolean",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "required",
                              "present",
                              "digestMatches"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "cursorChecks": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "stream": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "expectedNextSequence": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "suppliedNextSequence": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "matches": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "stream",
                              "expectedNextSequence",
                              "suppliedNextSequence",
                              "matches"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "effectChecks": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "disposition": {
                                "type": "string",
                                "enum": [
                                  "unsubmitted_claim",
                                  "settled_by_supplied_receipt",
                                  "unresolved"
                                ]
                              },
                              "suppliedOutcome": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "enum": [
                                      "success",
                                      "failure"
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "disposition",
                              "suppliedOutcome"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "limitations": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "matchesCheckpoint",
                        "advisoryOnly",
                        "authorizationGranted",
                        "checkpointId",
                        "stateSha256",
                        "digestProfile",
                        "requiresEffectReconciliation",
                        "artifactChecks",
                        "cursorChecks",
                        "effectChecks",
                        "limitations",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "checkpoint-handoff-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "checkpoint-handoff-v1",
                    "matchesCheckpoint": false,
                    "advisoryOnly": true,
                    "authorizationGranted": false,
                    "checkpointId": "checkpoint-1",
                    "stateSha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                    "digestProfile": "sorted-json-sha256-v1",
                    "requiresEffectReconciliation": true,
                    "artifactChecks": [
                      {
                        "id": "plan",
                        "required": true,
                        "present": true,
                        "digestMatches": true
                      }
                    ],
                    "cursorChecks": [
                      {
                        "stream": "events",
                        "expectedNextSequence": 4,
                        "suppliedNextSequence": 4,
                        "matches": true
                      }
                    ],
                    "effectChecks": [
                      {
                        "id": "send-1",
                        "disposition": "unresolved",
                        "suppliedOutcome": null
                      }
                    ],
                    "limitations": [
                      "Does not restore a checkpoint, dispatch an effect, verify identities, or authorize resumption.",
                      "State is hashed from supplied JSON. Artifact digests, receipts, phases and timestamps are compared as unverified claims; file bytes and provider state are not fetched.",
                      "Cursor nextSequence means the next unconsumed record in the caller's declared stream; equality does not prove no records were omitted.",
                      "A prepared phase is only an unsubmitted claim and is not evidence that dispatch is safe. Settled receipts do not prove exactly-once execution."
                    ],
                    "findings": [
                      {
                        "code": "EFFECT_RECEIPT_MISSING",
                        "severity": "error",
                        "path": "/checkpoint/effects/0",
                        "message": "Submitted or acknowledged effect requires a supplied receipt before reconciliation can complete",
                        "relatedIds": [
                          "send-1"
                        ]
                      }
                    ],
                    "findingCount": 1,
                    "errorCount": 1,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "d87ea4eabd4d2082ffa6fcef60b3ef17629a31bee0613b0cf1146fc71a3aab7e",
                    "outputSha256": "217ca73ac9f3bc755a530f25479c5a843646777c21b10015e9740f63d5fe2820",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/contract-capability-negotiate": {
      "post": {
        "operationId": "mpp_contract_capability_negotiate",
        "summary": "Contract capability intersection",
        "description": "Intersect 2–8 supplied capability offers, exact protocol/version/media identifiers and bounded size intervals. Return a deterministic common proposal or explicit conflicts; no negotiation, schema compatibility proof or authorization occurs.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/contract-capability-negotiate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find a common contract version and declared capabilities between agents",
            "Compare message and batch limits before exchanging artifacts"
          ],
          "whenToUse": [
            "Find a common contract version and declared capabilities between agents",
            "Compare message and batch limits before exchanging artifacts"
          ],
          "whenNotToUse": [
            "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution",
            "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees",
            "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness"
          ],
          "capabilities": [
            "Exact set intersection and required-capability union",
            "Inclusive integer size intervals; lexicographic choice is not newest-version selection",
            "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "parties": 8,
            "versionsPerParty": 32,
            "capabilitiesPerParty": 32
          },
          "related": [
            "json-schema-compatibility",
            "contract-version-route"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "VERSION_LIMIT",
            "ITEM_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "offers": {
                    "minItems": 2,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "party": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "protocol": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "versions": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "mediaTypes": {
                          "minItems": 1,
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "capabilities": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "requiredCapabilities": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "minimumMessageBytes": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100000000
                        },
                        "maximumMessageBytes": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100000000
                        },
                        "minimumBatchItems": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10000
                        },
                        "maximumBatchItems": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10000
                        }
                      },
                      "required": [
                        "party",
                        "protocol",
                        "versions",
                        "mediaTypes",
                        "capabilities",
                        "requiredCapabilities",
                        "minimumMessageBytes",
                        "maximumMessageBytes",
                        "minimumBatchItems",
                        "maximumBatchItems"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "offers"
                ],
                "additionalProperties": false
              },
              "example": {
                "offers": [
                  {
                    "party": "producer",
                    "protocol": "agent-exchange",
                    "versions": [
                      "1",
                      "2"
                    ],
                    "mediaTypes": [
                      "application/json"
                    ],
                    "capabilities": [
                      "cursor",
                      "digest"
                    ],
                    "requiredCapabilities": [
                      "digest"
                    ],
                    "minimumMessageBytes": 1,
                    "maximumMessageBytes": 65536,
                    "minimumBatchItems": 1,
                    "maximumBatchItems": 32
                  },
                  {
                    "party": "consumer",
                    "protocol": "agent-exchange",
                    "versions": [
                      "2"
                    ],
                    "mediaTypes": [
                      "application/json"
                    ],
                    "capabilities": [
                      "cursor",
                      "digest"
                    ],
                    "requiredCapabilities": [
                      "digest"
                    ],
                    "minimumMessageBytes": 1,
                    "maximumMessageBytes": 32768,
                    "minimumBatchItems": 1,
                    "maximumBatchItems": 32
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "contract-capability-negotiate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "contract-capability-intersection-v1"
                        },
                        "compatibleDeclarations": {
                          "type": "boolean"
                        },
                        "protocol": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "commonVersions": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "commonMediaTypes": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "commonCapabilities": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "requiredCapabilities": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "selection": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "version": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "mediaType": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "minimumMessageBytes": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "maximumMessageBytes": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "minimumBatchItems": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "maximumBatchItems": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "version",
                                "mediaType",
                                "minimumMessageBytes",
                                "maximumMessageBytes",
                                "minimumBatchItems",
                                "maximumBatchItems"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "selectionPolicy": {
                          "type": "string",
                          "const": "lexicographic-first-version-and-media-type"
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "compatibleDeclarations",
                        "protocol",
                        "commonVersions",
                        "commonMediaTypes",
                        "commonCapabilities",
                        "requiredCapabilities",
                        "selection",
                        "selectionPolicy",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated",
                        "advisoryOnly",
                        "execution",
                        "authorizationGranted"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "contract-capability-negotiate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "contract-capability-intersection-v1",
                    "compatibleDeclarations": true,
                    "protocol": "agent-exchange",
                    "commonVersions": [
                      "2"
                    ],
                    "commonMediaTypes": [
                      "application/json"
                    ],
                    "commonCapabilities": [
                      "cursor",
                      "digest"
                    ],
                    "requiredCapabilities": [
                      "digest"
                    ],
                    "selection": {
                      "version": "2",
                      "mediaType": "application/json",
                      "minimumMessageBytes": 1,
                      "maximumMessageBytes": 32768,
                      "minimumBatchItems": 1,
                      "maximumBatchItems": 32
                    },
                    "selectionPolicy": "lexicographic-first-version-and-media-type",
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false,
                    "advisoryOnly": true,
                    "execution": false,
                    "authorizationGranted": false
                  },
                  "provenance": {
                    "inputSha256": "4fb7645310512b039a130583f3563bf82879d9a262987e2fe833361cb966f2e6",
                    "outputSha256": "92caafb7a800cd6179eff138af48895244dd681561014116a3f810cf850bcdf0",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/contract-version-route": {
      "post": {
        "operationId": "mpp_contract_version_route",
        "summary": "Declared contract migration route",
        "description": "Choose a bounded minimum-cost route through a supplied directed version-migration manifest, respecting explicit lossy-step, cost and step limits. Version IDs are opaque; no migrations run and declared compatibility is not independently verified.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/contract-version-route.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Plan a declared contract migration path between agent versions",
            "Find a lowest-cost adapter chain without allowing declared data loss"
          ],
          "whenToUse": [
            "Plan a declared contract migration path between agent versions",
            "Find a lowest-cost adapter chain without allowing declared data loss"
          ],
          "whenNotToUse": [
            "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution",
            "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees",
            "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness"
          ],
          "capabilities": [
            "Bounded dynamic programming over supplied directed edges, including cycles",
            "Lowest cost, then fewest steps, then exact lexicographic migration IDs",
            "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "migrations": 256,
            "distinctVersions": 128,
            "maximumSteps": 32
          },
          "related": [
            "contract-capability-negotiate",
            "json-schema-compatibility"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "VERSION_LIMIT",
            "ITEM_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "contract": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "sourceVersion": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "targetVersions": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  },
                  "migrations": {
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "from": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "to": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "costUnits": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000
                        },
                        "lossy": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "id",
                        "from",
                        "to",
                        "costUnits",
                        "lossy"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "allowLossy": {
                    "type": "boolean"
                  },
                  "maximumCostUnits": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000000
                  },
                  "maximumSteps": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 32
                  }
                },
                "required": [
                  "contract",
                  "sourceVersion",
                  "targetVersions",
                  "migrations",
                  "allowLossy",
                  "maximumCostUnits",
                  "maximumSteps"
                ],
                "additionalProperties": false
              },
              "example": {
                "contract": "task-record",
                "sourceVersion": "v1",
                "targetVersions": [
                  "v3"
                ],
                "migrations": [
                  {
                    "id": "one-two",
                    "from": "v1",
                    "to": "v2",
                    "costUnits": 2,
                    "lossy": false
                  },
                  {
                    "id": "two-three",
                    "from": "v2",
                    "to": "v3",
                    "costUnits": 3,
                    "lossy": false
                  }
                ],
                "allowLossy": false,
                "maximumCostUnits": 10,
                "maximumSteps": 4
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "contract-version-route",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "declared-contract-route-v1"
                        },
                        "contract": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "manifestValid": {
                          "type": "boolean"
                        },
                        "routeFound": {
                          "type": "boolean"
                        },
                        "route": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "targetVersion": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "costUnits": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "migrationIds": {
                                  "maxItems": 32,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  }
                                },
                                "versions": {
                                  "minItems": 1,
                                  "maxItems": 33,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  }
                                },
                                "containsLossyStep": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "targetVersion",
                                "costUnits",
                                "migrationIds",
                                "versions",
                                "containsLossyStep"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "selectionPolicy": {
                          "type": "string",
                          "const": "lowest-cost-then-fewest-steps-then-lexicographic-migration-ids"
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "contract",
                        "manifestValid",
                        "routeFound",
                        "route",
                        "selectionPolicy",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated",
                        "advisoryOnly",
                        "execution",
                        "authorizationGranted"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "contract-version-route",
                  "version": "0.29.0",
                  "result": {
                    "profile": "declared-contract-route-v1",
                    "contract": "task-record",
                    "manifestValid": true,
                    "routeFound": true,
                    "route": {
                      "targetVersion": "v3",
                      "costUnits": 5,
                      "migrationIds": [
                        "one-two",
                        "two-three"
                      ],
                      "versions": [
                        "v1",
                        "v2",
                        "v3"
                      ],
                      "containsLossyStep": false
                    },
                    "selectionPolicy": "lowest-cost-then-fewest-steps-then-lexicographic-migration-ids",
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false,
                    "advisoryOnly": true,
                    "execution": false,
                    "authorizationGranted": false
                  },
                  "provenance": {
                    "inputSha256": "60660389c7f5faa2d281b5746c520fe91095b938f9a171d927d7a9bdaf2c3837",
                    "outputSha256": "452b5e31f3af797da7880d0a594c7262ca6af4602c3241c4601e3e68ff18a7d3",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/message-batch-plan": {
      "post": {
        "operationId": "mpp_message_batch_plan",
        "summary": "Message batch contiguous-prefix plan",
        "description": "Inspect up to 256 supplied message envelopes against stream checkpoints, explicit duplicate rules and sequence-slot identity. Propose a contiguous ordered prefix per stream, stopping at gaps and withholding every plan on structural conflicts. No messages are delivered or consumed.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/message-batch-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Order an agent message batch without skipping missing sequence numbers",
            "Deduplicate identical message envelopes under an explicit policy"
          ],
          "whenToUse": [
            "Order an agent message batch without skipping missing sequence numbers",
            "Deduplicate identical message envelopes under an explicit policy"
          ],
          "whenNotToUse": [
            "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution",
            "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees",
            "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness"
          ],
          "capabilities": [
            "Exact message-ID and stream-sequence conflict detection",
            "All-or-nothing conflict handling; independent stream prefixes stop at gaps",
            "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "streams": 32,
            "messages": 256
          },
          "related": [
            "causal-log-check",
            "checkpoint-handoff-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "VERSION_LIMIT",
            "ITEM_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "streams": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "nextSequence": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "id",
                        "nextSequence"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "messages": {
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "stream": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "sequence": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740990
                        },
                        "contentSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        }
                      },
                      "required": [
                        "id",
                        "stream",
                        "sequence",
                        "contentSha256"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "duplicatePolicy": {
                    "type": "string",
                    "enum": [
                      "keep-first-identical",
                      "reject"
                    ]
                  }
                },
                "required": [
                  "streams",
                  "messages",
                  "duplicatePolicy"
                ],
                "additionalProperties": false
              },
              "example": {
                "streams": [
                  {
                    "id": "jobs",
                    "nextSequence": 4
                  }
                ],
                "duplicatePolicy": "keep-first-identical",
                "messages": [
                  {
                    "id": "m5",
                    "stream": "jobs",
                    "sequence": 5,
                    "contentSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
                  },
                  {
                    "id": "m4",
                    "stream": "jobs",
                    "sequence": 4,
                    "contentSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "message-batch-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "message-batch-contiguous-prefix-v1"
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "allRemainingMessagesSelected": {
                          "type": "boolean"
                        },
                        "plans": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "stream": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "messageIds": {
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              },
                              "inputIndices": {
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "nextSequence": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "gapAt": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "stream",
                              "messageIds",
                              "inputIndices",
                              "nextSequence",
                              "gapAt"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "dispositions": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "messageId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "disposition": {
                                "type": "string",
                                "enum": [
                                  "selected",
                                  "exact_duplicate",
                                  "before_checkpoint",
                                  "blocked_gap",
                                  "conflict",
                                  "unknown_stream",
                                  "held_invalid_batch"
                                ]
                              }
                            },
                            "required": [
                              "inputIndex",
                              "messageId",
                              "disposition"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "orderingPolicy": {
                          "type": "string",
                          "const": "input-stream-order-then-ascending-sequence"
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "consistent",
                        "allRemainingMessagesSelected",
                        "plans",
                        "dispositions",
                        "orderingPolicy",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated",
                        "advisoryOnly",
                        "execution",
                        "authorizationGranted"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "message-batch-plan",
                  "version": "0.29.0",
                  "result": {
                    "profile": "message-batch-contiguous-prefix-v1",
                    "consistent": true,
                    "allRemainingMessagesSelected": true,
                    "plans": [
                      {
                        "stream": "jobs",
                        "messageIds": [
                          "m4",
                          "m5"
                        ],
                        "inputIndices": [
                          1,
                          0
                        ],
                        "nextSequence": 6,
                        "gapAt": null
                      }
                    ],
                    "dispositions": [
                      {
                        "inputIndex": 0,
                        "messageId": "m5",
                        "disposition": "selected"
                      },
                      {
                        "inputIndex": 1,
                        "messageId": "m4",
                        "disposition": "selected"
                      }
                    ],
                    "orderingPolicy": "input-stream-order-then-ascending-sequence",
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false,
                    "advisoryOnly": true,
                    "execution": false,
                    "authorizationGranted": false
                  },
                  "provenance": {
                    "inputSha256": "476b2632476a1d18051d6e887e497daa163a23f2f23b75c700f3244df1b9ce5e",
                    "outputSha256": "d148b30c422eb8c1f665e97e9aa41814ac5be288467d671637bfa33cea57eedf",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/pagination-chain-check": {
      "post": {
        "operationId": "mpp_pagination_chain_check",
        "summary": "Pagination snapshot-chain check",
        "description": "Validate a supplied page chain for consecutive numbers, cursor continuity and cycles, fixed snapshot/query digests, and item-ID/content conflicts. Return a checkpoint only for a consistent chain. A terminal marker is not proof of a complete live dataset.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/pagination-chain-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Check pagination cursor continuity before handing a checkpoint to another agent",
            "Detect snapshot drift and repeated records in captured API pages"
          ],
          "whenToUse": [
            "Check pagination cursor continuity before handing a checkpoint to another agent",
            "Detect snapshot drift and repeated records in captured API pages"
          ],
          "whenNotToUse": [
            "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution",
            "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees",
            "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness"
          ],
          "capabilities": [
            "Exact opaque cursor chaining with explicit null terminal markers",
            "Supplied item digests and explicit duplicate-item policy; no page fetching",
            "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "pages": 128,
            "itemsPerPage": 256,
            "totalItems": 512,
            "cursorCharacters": 256
          },
          "related": [
            "checkpoint-handoff-check",
            "http-link-parse"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "VERSION_LIMIT",
            "ITEM_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "snapshotId": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "querySha256": {
                    "type": "string",
                    "pattern": "^[a-f0-9]{64}$"
                  },
                  "startCursor": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 256
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "firstPageNumber": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740863
                  },
                  "duplicateItemPolicy": {
                    "type": "string",
                    "enum": [
                      "reject",
                      "allow-identical"
                    ]
                  },
                  "pages": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "pageNumber": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "requestCursor": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "nextCursor": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "snapshotId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "querySha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "items": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "contentSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              }
                            },
                            "required": [
                              "id",
                              "contentSha256"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "pageNumber",
                        "requestCursor",
                        "nextCursor",
                        "snapshotId",
                        "querySha256",
                        "items"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "snapshotId",
                  "querySha256",
                  "startCursor",
                  "firstPageNumber",
                  "duplicateItemPolicy",
                  "pages"
                ],
                "additionalProperties": false
              },
              "example": {
                "snapshotId": "snapshot-1",
                "querySha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "startCursor": null,
                "firstPageNumber": 0,
                "duplicateItemPolicy": "reject",
                "pages": [
                  {
                    "pageNumber": 0,
                    "requestCursor": null,
                    "nextCursor": "page-two",
                    "snapshotId": "snapshot-1",
                    "querySha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                    "items": [
                      {
                        "id": "item-1",
                        "contentSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "pagination-chain-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "pagination-chain-snapshot-v1"
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "pageCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "itemCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "uniqueItemCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "terminalObserved": {
                          "type": "boolean"
                        },
                        "checkpoint": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "snapshotId": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "querySha256": {
                                  "type": "string",
                                  "pattern": "^[a-f0-9]{64}$"
                                },
                                "nextPageNumber": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "nextCursor": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 256
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "terminal": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "snapshotId",
                                "querySha256",
                                "nextPageNumber",
                                "nextCursor",
                                "terminal"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "consistent",
                        "pageCount",
                        "itemCount",
                        "uniqueItemCount",
                        "terminalObserved",
                        "checkpoint",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated",
                        "advisoryOnly",
                        "execution",
                        "authorizationGranted"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "pagination-chain-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "pagination-chain-snapshot-v1",
                    "consistent": true,
                    "pageCount": 1,
                    "itemCount": 1,
                    "uniqueItemCount": 1,
                    "terminalObserved": false,
                    "checkpoint": {
                      "snapshotId": "snapshot-1",
                      "querySha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                      "nextPageNumber": 1,
                      "nextCursor": "page-two",
                      "terminal": false
                    },
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false,
                    "advisoryOnly": true,
                    "execution": false,
                    "authorizationGranted": false
                  },
                  "provenance": {
                    "inputSha256": "3355a2862c59019a9c2b5d9e859914e0cd3e228f852a68042ebf0054abf20ebe",
                    "outputSha256": "207f2a322c2aea3db1cad8d10b6ca29dffbfe4726773165c8e0907226f4e24eb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/artifact-lineage-check": {
      "post": {
        "operationId": "mpp_artifact_lineage_check",
        "summary": "Artifact derivation lineage check",
        "description": "Check a supplied artifact derivation graph for parent-digest and media-type agreement, missing or cyclic ancestry, and required/forbidden ancestor or depth constraints. Inspect only supplied manifests; no artifact bytes, derivations, identities or source authenticity are verified.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/artifact-lineage-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate artifact parent digests and transformation media contracts",
            "Check required or forbidden source ancestry before accepting an agent artifact"
          ],
          "whenToUse": [
            "Validate artifact parent digests and transformation media contracts",
            "Check required or forbidden source ancestry before accepting an agent artifact"
          ],
          "whenNotToUse": [
            "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution",
            "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees",
            "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness"
          ],
          "capabilities": [
            "Derived/source distinction and exact digest/type checks across edges",
            "Transitive ancestor constraints, roots and longest chain depth on valid graphs",
            "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "artifacts": 128,
            "parentsPerArtifact": 16,
            "targets": 32,
            "ancestorsPerConstraint": 32
          },
          "related": [
            "artifact-manifest-check",
            "workflow-dag-analyze"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "VERSION_LIMIT",
            "ITEM_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "artifacts": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "source",
                            "derived"
                          ]
                        },
                        "mediaType": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "parents": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "expectedSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              }
                            },
                            "required": [
                              "id",
                              "expectedSha256"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "derivation": {
                          "type": "object",
                          "properties": {
                            "operation": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "version": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "inputMediaTypes": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "outputMediaType": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            }
                          },
                          "required": [
                            "operation",
                            "version",
                            "inputMediaTypes",
                            "outputMediaType"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "id",
                        "sha256",
                        "kind",
                        "mediaType",
                        "parents"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "targets": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "artifactId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "expectedSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "requiredAncestors": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "forbiddenAncestors": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "maximumDepth": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 127
                        }
                      },
                      "required": [
                        "artifactId",
                        "requiredAncestors",
                        "forbiddenAncestors",
                        "maximumDepth"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "artifacts",
                  "targets"
                ],
                "additionalProperties": false
              },
              "example": {
                "artifacts": [
                  {
                    "id": "source",
                    "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                    "kind": "source",
                    "mediaType": "text/plain",
                    "parents": []
                  },
                  {
                    "id": "summary",
                    "sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "kind": "derived",
                    "mediaType": "application/json",
                    "parents": [
                      {
                        "id": "source",
                        "expectedSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
                      }
                    ],
                    "derivation": {
                      "operation": "extract",
                      "version": "1",
                      "inputMediaTypes": [
                        "text/plain"
                      ],
                      "outputMediaType": "application/json"
                    }
                  }
                ],
                "targets": [
                  {
                    "artifactId": "summary",
                    "expectedSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "requiredAncestors": [
                      "source"
                    ],
                    "forbiddenAncestors": [],
                    "maximumDepth": 2
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "artifact-lineage-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "artifact-derivation-lineage-v1"
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "targets": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "artifactId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "matchesRequirements": {
                                "type": "boolean"
                              },
                              "ancestors": {
                                "maxItems": 127,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              },
                              "rootSources": {
                                "maxItems": 128,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              },
                              "depth": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "completeSuppliedLineage": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "artifactId",
                              "matchesRequirements",
                              "ancestors",
                              "rootSources",
                              "depth",
                              "completeSuppliedLineage"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "relatedIds": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message",
                              "relatedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "errorCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "consistent",
                        "targets",
                        "findings",
                        "findingCount",
                        "errorCount",
                        "truncated",
                        "advisoryOnly",
                        "execution",
                        "authorizationGranted"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "artifact-lineage-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "artifact-derivation-lineage-v1",
                    "consistent": true,
                    "targets": [
                      {
                        "artifactId": "summary",
                        "matchesRequirements": true,
                        "ancestors": [
                          "source"
                        ],
                        "rootSources": [
                          "source"
                        ],
                        "depth": 1,
                        "completeSuppliedLineage": true
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "errorCount": 0,
                    "truncated": false,
                    "advisoryOnly": true,
                    "execution": false,
                    "authorizationGranted": false
                  },
                  "provenance": {
                    "inputSha256": "507af5b7f2bc18266841de2aad66dd74e0e46d7281b89d47ccc6c5e05c8c4882",
                    "outputSha256": "f67df918a8b3a3f449b877066a50d72013446c94a2e48a1c9d6f42ee9fefd167",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/numeric-rounding-check": {
      "post": {
        "operationId": "mpp_numeric_rounding_check",
        "summary": "Exact numeric rounding check",
        "description": "Check explicitly supplied decimal claims against five declared decimal-place rounding rules. Returns exact expected text, tie evidence and rational errors; no number extraction, unit inference or fact verification.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/numeric-rounding-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Check rounding consistency in an agent-generated numeric report",
            "Audit exact decimal tie handling without binary floating-point artifacts"
          ],
          "whenToUse": [
            "Check rounding consistency in an agent-generated numeric report",
            "Audit exact decimal tie handling without binary floating-point artifacts"
          ],
          "whenNotToUse": [
            "Extracting facts or judging truth, semantic correctness, evidence authenticity, causal effects, or production readiness",
            "Fetching data, executing models or user code, changing datasets, authorizing actions, or contacting live services",
            "Inferring population quality, statistical significance, uncertainty intervals, or generalization from a supplied sample"
          ],
          "capabilities": [
            "exact-decimal-rounding-v1 profile",
            "Exact decimal strings; half-even, half-away-from-zero, toward-zero, floor and ceiling",
            "Claim equality is numeric, not formatting equality; rational signed discrepancy and absolute rounding error",
            "Networkless supplied-evidence computation; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "claims": 200,
            "decimalPlaces": "0–18",
            "claimedIntegerDigits": 25
          },
          "related": [
            "units-convert",
            "interval-analyze"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_RULE",
            "DUPLICATE_ID",
            "UNKNOWN_CRITERION",
            "RECORD_LIMIT",
            "NUMERIC_COMPLEXITY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "claims": {
                    "minItems": 1,
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "source": {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                        },
                        "claimed": {
                          "type": "string",
                          "maxLength": 45,
                          "pattern": "^-?(?:0|[1-9]\\d{0,24})(?:\\.\\d{1,18})?$",
                          "description": "Exact claimed decimal; up to 25 integer digits to accommodate source rounding carry, and 18 fractional digits."
                        },
                        "decimalPlaces": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 18
                        },
                        "mode": {
                          "type": "string",
                          "enum": [
                            "half-even",
                            "half-away-from-zero",
                            "toward-zero",
                            "floor",
                            "ceiling"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "source",
                        "claimed",
                        "decimalPlaces",
                        "mode"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "claims"
                ],
                "additionalProperties": false
              },
              "example": {
                "claims": [
                  {
                    "id": "reported-rate",
                    "source": "1.245",
                    "claimed": "1.25",
                    "decimalPlaces": 2,
                    "mode": "half-even"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "numeric-rounding-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "exact-decimal-rounding-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "consistent": {
                          "type": "boolean"
                        },
                        "checkedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "mismatchCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "claims": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "consistent": {
                                "type": "boolean"
                              },
                              "expected": {
                                "type": "string",
                                "maxLength": 64
                              },
                              "claimedMinusExpected": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 2049,
                                    "pattern": "^-?(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 2048,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "absoluteRoundingError": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 2049,
                                    "pattern": "^-?(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 2048,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "exact": {
                                "type": "boolean"
                              },
                              "tie": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "id",
                              "consistent",
                              "expected",
                              "claimedMinusExpected",
                              "absoluteRoundingError",
                              "exact",
                              "tie"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "semanticValidityVerified",
                        "consistent",
                        "checkedCount",
                        "mismatchCount",
                        "claims"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "numeric-rounding-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-decimal-rounding-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "semanticValidityVerified": false,
                    "consistent": false,
                    "checkedCount": 1,
                    "mismatchCount": 1,
                    "claims": [
                      {
                        "id": "reported-rate",
                        "consistent": false,
                        "expected": "1.24",
                        "claimedMinusExpected": {
                          "numerator": "1",
                          "denominator": "100"
                        },
                        "absoluteRoundingError": {
                          "numerator": "1",
                          "denominator": "200"
                        },
                        "exact": false,
                        "tie": true
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "2da0fae2a30e8eef6a180e1763cd895c4824e08ba9556b32cc202086910ff43e",
                    "outputSha256": "8883a6ae66f0b6b32c704129b98492523391975e090ed6e75e68e2e05de68a27",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/rubric-score-aggregate": {
      "post": {
        "operationId": "mpp_rubric_score_aggregate",
        "summary": "Missingness-aware rubric aggregation",
        "description": "Aggregate supplied weighted rubric scores with exact normalized fractions and conservative lower/upper bounds for missing ratings. Optional threshold reports certain pass, certain fail or unknown; does not assign ratings or renormalize away missing criteria.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/rubric-score-aggregate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Aggregate an explicit agent evaluation rubric without hiding missing scores",
            "Determine whether omitted rubric ratings can change a supplied pass threshold"
          ],
          "whenToUse": [
            "Aggregate an explicit agent evaluation rubric without hiding missing scores",
            "Determine whether omitted rubric ratings can change a supplied pass threshold"
          ],
          "whenNotToUse": [
            "Extracting facts or judging truth, semantic correctness, evidence authenticity, causal effects, or production readiness",
            "Fetching data, executing models or user code, changing datasets, authorizing actions, or contacting live services",
            "Inferring population quality, statistical significance, uncertainty intervals, or generalization from a supplied sample"
          ],
          "capabilities": [
            "bounded-rubric-aggregation-v1 profile",
            "Positive exact weights; score/maxScore normalization; full-weight denominator",
            "Missing scores span zero to maximum; exact score remains null until complete",
            "Networkless supplied-evidence computation; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "criteria": 100,
            "ratings": 100,
            "maxScore": "positive safe integer at most 1,000,000"
          },
          "related": [
            "classification-evaluate",
            "metric-regression-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_RULE",
            "DUPLICATE_ID",
            "UNKNOWN_CRITERION",
            "RECORD_LIMIT",
            "NUMERIC_COMPLEXITY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "criteria": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "weight": {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                        },
                        "maxScore": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000
                        }
                      },
                      "required": [
                        "id",
                        "weight",
                        "maxScore"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "ratings": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "criterionId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "score": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 44,
                              "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                              "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "criterionId",
                        "score"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "passThreshold": {
                    "type": "string",
                    "maxLength": 44,
                    "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                    "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                  }
                },
                "required": [
                  "criteria",
                  "ratings"
                ],
                "additionalProperties": false
              },
              "example": {
                "criteria": [
                  {
                    "id": "correctness",
                    "weight": "3",
                    "maxScore": 5
                  },
                  {
                    "id": "completeness",
                    "weight": "1",
                    "maxScore": 5
                  }
                ],
                "ratings": [
                  {
                    "criterionId": "correctness",
                    "score": "4"
                  }
                ],
                "passThreshold": "0.8"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "rubric-score-aggregate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "bounded-rubric-aggregation-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "complete": {
                          "type": "boolean"
                        },
                        "criterionCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "ratedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "missingCriterionIds": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "totalWeight": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "observedWeight": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "observedWeightFraction": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "score": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "lowerBound": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "upperBound": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "threshold": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "thresholdStatus": {
                          "type": "string",
                          "enum": [
                            "passed",
                            "failed",
                            "unknown",
                            "not_requested"
                          ]
                        },
                        "criteria": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "rated",
                                  "missing"
                                ]
                              },
                              "normalizedScore": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "weightedContribution": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "status",
                              "normalizedScore",
                              "weightedContribution"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "semanticValidityVerified",
                        "complete",
                        "criterionCount",
                        "ratedCount",
                        "missingCriterionIds",
                        "totalWeight",
                        "observedWeight",
                        "observedWeightFraction",
                        "score",
                        "lowerBound",
                        "upperBound",
                        "threshold",
                        "thresholdStatus",
                        "criteria"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "rubric-score-aggregate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "bounded-rubric-aggregation-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "semanticValidityVerified": false,
                    "complete": false,
                    "criterionCount": 2,
                    "ratedCount": 1,
                    "missingCriterionIds": [
                      "completeness"
                    ],
                    "totalWeight": {
                      "numerator": "4",
                      "denominator": "1"
                    },
                    "observedWeight": {
                      "numerator": "3",
                      "denominator": "1"
                    },
                    "observedWeightFraction": {
                      "numerator": "3",
                      "denominator": "4"
                    },
                    "score": null,
                    "lowerBound": {
                      "numerator": "3",
                      "denominator": "5"
                    },
                    "upperBound": {
                      "numerator": "17",
                      "denominator": "20"
                    },
                    "threshold": {
                      "numerator": "4",
                      "denominator": "5"
                    },
                    "thresholdStatus": "unknown",
                    "criteria": [
                      {
                        "id": "correctness",
                        "status": "rated",
                        "normalizedScore": {
                          "numerator": "4",
                          "denominator": "5"
                        },
                        "weightedContribution": {
                          "numerator": "12",
                          "denominator": "5"
                        }
                      },
                      {
                        "id": "completeness",
                        "status": "missing",
                        "normalizedScore": null,
                        "weightedContribution": null
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "45069751e8b836c12a37d9ea034ccde629e808399600b9febcd60bbf996804ac",
                    "outputSha256": "26c2563fe2e5c4094cb9eb65f344987cb0758eaa7939797d4f372bff4e149f10",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/dataset-split-audit": {
      "post": {
        "operationId": "mpp_dataset_split_audit",
        "summary": "Declared dataset split overlap audit",
        "description": "Find exact item ID, group ID and supplied SHA-256 fingerprint overlaps across caller-declared dataset partitions. Reports missing identity coverage and capped locations; no data fetching, hash verification, near-duplicate detection or proof of leakage-free evaluation.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/dataset-split-audit.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find exact train validation test overlap from supplied IDs and group keys",
            "Audit group leakage candidates before an agent evaluation run"
          ],
          "whenToUse": [
            "Find exact train validation test overlap from supplied IDs and group keys",
            "Audit group leakage candidates before an agent evaluation run"
          ],
          "whenNotToUse": [
            "Extracting facts or judging truth, semantic correctness, evidence authenticity, causal effects, or production readiness",
            "Fetching data, executing models or user code, changing datasets, authorizing actions, or contacting live services",
            "Inferring population quality, statistical significance, uncertainty intervals, or generalization from a supplied sample"
          ],
          "capabilities": [
            "declared-dataset-split-v1 profile",
            "Exact case-sensitive item/group/fingerprint equality across named partitions",
            "Counts retain full bounded evidence totals; at most 200 evidence groups and eight locations each",
            "Networkless supplied-evidence computation; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "partitions": 16,
            "totalRecords": 1000,
            "locationsPerEvidence": 8
          },
          "related": [
            "record-relations",
            "record-profile"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_RULE",
            "DUPLICATE_ID",
            "UNKNOWN_CRITERION",
            "RECORD_LIMIT",
            "NUMERIC_COMPLEXITY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "partitions": {
                    "minItems": 2,
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "records": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "itemId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "groupId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "fingerprint": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              }
                            },
                            "required": [
                              "itemId"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "records"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "partitions"
                ],
                "additionalProperties": false
              },
              "example": {
                "partitions": [
                  {
                    "id": "train",
                    "records": [
                      {
                        "itemId": "row-1",
                        "groupId": "conversation-a"
                      }
                    ]
                  },
                  {
                    "id": "test",
                    "records": [
                      {
                        "itemId": "row-2",
                        "groupId": "conversation-a"
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "dataset-split-audit",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "declared-dataset-split-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "overlap_detected",
                            "no_observed_overlap"
                          ]
                        },
                        "recordCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "partitionCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "crossPartitionValueCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "duplicateIdentityValueCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "evidenceTruncated": {
                          "type": "boolean"
                        },
                        "dimensions": {
                          "minItems": 3,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "field": {
                                "type": "string",
                                "enum": [
                                  "itemId",
                                  "groupId",
                                  "fingerprint"
                                ]
                              },
                              "suppliedCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "missingCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "distinctValueCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "crossPartitionValueCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "withinPartitionDuplicateValueCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "field",
                              "suppliedCount",
                              "missingCount",
                              "distinctValueCount",
                              "crossPartitionValueCount",
                              "withinPartitionDuplicateValueCount"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "evidence": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "field": {
                                "type": "string",
                                "enum": [
                                  "itemId",
                                  "groupId",
                                  "fingerprint"
                                ]
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 100
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "cross_partition",
                                  "within_partition_duplicate"
                                ]
                              },
                              "partitions": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                }
                              },
                              "recordCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "locations": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "partitionId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    "recordIndex": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "partitionId",
                                    "recordIndex"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "locationsTruncated": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "field",
                              "value",
                              "kind",
                              "partitions",
                              "recordCount",
                              "locations",
                              "locationsTruncated"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "semanticValidityVerified",
                        "status",
                        "recordCount",
                        "partitionCount",
                        "crossPartitionValueCount",
                        "duplicateIdentityValueCount",
                        "evidenceTruncated",
                        "dimensions",
                        "evidence"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "dataset-split-audit",
                  "version": "0.29.0",
                  "result": {
                    "profile": "declared-dataset-split-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "semanticValidityVerified": false,
                    "status": "overlap_detected",
                    "recordCount": 2,
                    "partitionCount": 2,
                    "crossPartitionValueCount": 1,
                    "duplicateIdentityValueCount": 0,
                    "evidenceTruncated": false,
                    "dimensions": [
                      {
                        "field": "itemId",
                        "suppliedCount": 2,
                        "missingCount": 0,
                        "distinctValueCount": 2,
                        "crossPartitionValueCount": 0,
                        "withinPartitionDuplicateValueCount": 0
                      },
                      {
                        "field": "groupId",
                        "suppliedCount": 2,
                        "missingCount": 0,
                        "distinctValueCount": 1,
                        "crossPartitionValueCount": 1,
                        "withinPartitionDuplicateValueCount": 0
                      },
                      {
                        "field": "fingerprint",
                        "suppliedCount": 0,
                        "missingCount": 2,
                        "distinctValueCount": 0,
                        "crossPartitionValueCount": 0,
                        "withinPartitionDuplicateValueCount": 0
                      }
                    ],
                    "evidence": [
                      {
                        "field": "groupId",
                        "value": "conversation-a",
                        "kind": "cross_partition",
                        "partitions": [
                          "test",
                          "train"
                        ],
                        "recordCount": 2,
                        "locations": [
                          {
                            "partitionId": "train",
                            "recordIndex": 0
                          },
                          {
                            "partitionId": "test",
                            "recordIndex": 0
                          }
                        ],
                        "locationsTruncated": false
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "c8e7bbf2610fd939ea9da8f874a37291d4ae5a8974620b50c21c85ee55ccf176",
                    "outputSha256": "acc76f8ae28f14ba1a38a39e21620cfb14d5addd64337ee522bf5c7c5c81f6bb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/metric-regression-check": {
      "post": {
        "operationId": "mpp_metric_regression_check",
        "summary": "Exact metric regression budget check",
        "description": "Compare supplied baseline/candidate decimal measurements against explicit directional absolute and relative regression budgets. Missing values stay unknown; every configured budget must pass. No benchmarking, unit conversion, noise model or significance test.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/metric-regression-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Gate supplied agent benchmark changes against explicit regression budgets",
            "Compare baseline and candidate measurements while preserving missing evidence"
          ],
          "whenToUse": [
            "Gate supplied agent benchmark changes against explicit regression budgets",
            "Compare baseline and candidate measurements while preserving missing evidence"
          ],
          "whenNotToUse": [
            "Extracting facts or judging truth, semantic correctness, evidence authenticity, causal effects, or production readiness",
            "Fetching data, executing models or user code, changing datasets, authorizing actions, or contacting live services",
            "Inferring population quality, statistical significance, uncertainty intervals, or generalization from a supplied sample"
          ],
          "capabilities": [
            "exact-metric-regression-v1 profile",
            "All configured budgets must hold; relative limit is abs(baseline) times ratio",
            "Zero baseline yields null relative ratio and zero relative allowance; improvements have zero degradation",
            "Networkless supplied-evidence computation; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "metrics": 200
          },
          "related": [
            "rubric-score-aggregate",
            "replay-divergence-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_RULE",
            "DUPLICATE_ID",
            "UNKNOWN_CRITERION",
            "RECORD_LIMIT",
            "NUMERIC_COMPLEXITY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "metrics": {
                    "minItems": 1,
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "unit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "direction": {
                          "type": "string",
                          "enum": [
                            "lower_is_better",
                            "higher_is_better"
                          ]
                        },
                        "baseline": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 44,
                              "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                              "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "candidate": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 44,
                              "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                              "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "maxAbsoluteRegression": {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                        },
                        "maxRelativeRegression": {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                        }
                      },
                      "required": [
                        "id",
                        "unit",
                        "direction",
                        "baseline",
                        "candidate"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "metrics"
                ],
                "additionalProperties": false
              },
              "example": {
                "metrics": [
                  {
                    "id": "p95-latency",
                    "unit": "ms",
                    "direction": "lower_is_better",
                    "baseline": "100",
                    "candidate": "106",
                    "maxAbsoluteRegression": "10",
                    "maxRelativeRegression": "0.05"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "metric-regression-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "exact-metric-regression-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "passed",
                            "failed",
                            "unknown"
                          ]
                        },
                        "passedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "failedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "unknownCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "metrics": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "unit": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "passed",
                                  "failed",
                                  "unknown"
                                ]
                              },
                              "missing": {
                                "maxItems": 2,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "baseline",
                                    "candidate"
                                  ]
                                }
                              },
                              "delta": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "degradation": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "relativeDegradation": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "zeroBaseline": {
                                "type": [
                                  "boolean",
                                  "null"
                                ]
                              },
                              "absoluteBudget": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "limit": {
                                        "type": "object",
                                        "properties": {
                                          "numerator": {
                                            "type": "string",
                                            "maxLength": 2049,
                                            "pattern": "^-?(?:0|[1-9]\\d*)$"
                                          },
                                          "denominator": {
                                            "type": "string",
                                            "maxLength": 2048,
                                            "pattern": "^[1-9]\\d*$"
                                          }
                                        },
                                        "required": [
                                          "numerator",
                                          "denominator"
                                        ],
                                        "additionalProperties": false
                                      },
                                      "withinBudget": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "limit",
                                      "withinBudget"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "relativeBudget": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "limit": {
                                        "type": "object",
                                        "properties": {
                                          "numerator": {
                                            "type": "string",
                                            "maxLength": 2049,
                                            "pattern": "^-?(?:0|[1-9]\\d*)$"
                                          },
                                          "denominator": {
                                            "type": "string",
                                            "maxLength": 2048,
                                            "pattern": "^[1-9]\\d*$"
                                          }
                                        },
                                        "required": [
                                          "numerator",
                                          "denominator"
                                        ],
                                        "additionalProperties": false
                                      },
                                      "withinBudget": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "limit",
                                      "withinBudget"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "unit",
                              "status",
                              "missing",
                              "delta",
                              "degradation",
                              "relativeDegradation",
                              "zeroBaseline",
                              "absoluteBudget",
                              "relativeBudget"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "semanticValidityVerified",
                        "status",
                        "passedCount",
                        "failedCount",
                        "unknownCount",
                        "metrics"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "metric-regression-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-metric-regression-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "semanticValidityVerified": false,
                    "status": "failed",
                    "passedCount": 0,
                    "failedCount": 1,
                    "unknownCount": 0,
                    "metrics": [
                      {
                        "id": "p95-latency",
                        "unit": "ms",
                        "status": "failed",
                        "missing": [],
                        "delta": {
                          "numerator": "6",
                          "denominator": "1"
                        },
                        "degradation": {
                          "numerator": "6",
                          "denominator": "1"
                        },
                        "relativeDegradation": {
                          "numerator": "3",
                          "denominator": "50"
                        },
                        "zeroBaseline": false,
                        "absoluteBudget": {
                          "limit": {
                            "numerator": "10",
                            "denominator": "1"
                          },
                          "withinBudget": true
                        },
                        "relativeBudget": {
                          "limit": {
                            "numerator": "5",
                            "denominator": "1"
                          },
                          "withinBudget": false
                        }
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "91ca7032db19ed1509a034d76d4207e3a4816fdd2f1d8685772fae5e8d95c91a",
                    "outputSha256": "d3723d6e6614497e8f659f57baacc4bddc88d08396961c3a9d526f374f0a6c7d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/prediction-calibration-check": {
      "post": {
        "operationId": "mpp_prediction_calibration_check",
        "summary": "Supplied binary probability calibration",
        "description": "Compute exact binary Brier score and uniform-bin calibration diagnostics from supplied probabilities and nullable Boolean outcomes. Reports label coverage and per-row errors; no learned calibration, confidence intervals, forecast validity or population-quality claim.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/prediction-calibration-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Evaluate supplied agent confidence probabilities against binary outcomes",
            "Inspect Brier error and reliability bins without dropping unknown labels silently"
          ],
          "whenToUse": [
            "Evaluate supplied agent confidence probabilities against binary outcomes",
            "Inspect Brier error and reliability bins without dropping unknown labels silently"
          ],
          "whenNotToUse": [
            "Extracting facts or judging truth, semantic correctness, evidence authenticity, causal effects, or production readiness",
            "Fetching data, executing models or user code, changing datasets, authorizing actions, or contacting live services",
            "Inferring population quality, statistical significance, uncertainty intervals, or generalization from a supplied sample"
          ],
          "capabilities": [
            "binary-probability-calibration-v1 profile",
            "Binary Brier mean (p-y)^2, count-weighted absolute bin gap and maximum nonempty-bin gap",
            "Uniform [lower,upper) bins with final upper inclusive; labeled-only metrics and explicit unknown counts",
            "Networkless supplied-evidence computation; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "predictions": 1000,
            "binCount": "1–20"
          },
          "related": [
            "classification-evaluate",
            "metric-regression-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_RULE",
            "DUPLICATE_ID",
            "UNKNOWN_CRITERION",
            "RECORD_LIMIT",
            "NUMERIC_COMPLEXITY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "predictions": {
                    "minItems": 1,
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "probability": {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Exact decimal string: up to 24 integer and 18 fractional digits; no exponent, plus sign, whitespace, or leading zeros."
                        },
                        "outcome": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "probability",
                        "outcome"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "binCount": {
                    "default": 10,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20
                  }
                },
                "required": [
                  "predictions"
                ],
                "additionalProperties": false
              },
              "example": {
                "binCount": 2,
                "predictions": [
                  {
                    "id": "case-1",
                    "probability": "0.8",
                    "outcome": true
                  },
                  {
                    "id": "case-2",
                    "probability": "0.8",
                    "outcome": false
                  },
                  {
                    "id": "case-3",
                    "probability": "0.2",
                    "outcome": null
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "prediction-calibration-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "binary-probability-calibration-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "predictionCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "labeledCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "unknownOutcomeCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "complete": {
                          "type": "boolean"
                        },
                        "brierScore": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "expectedCalibrationError": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "maximumCalibrationGap": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "bins": {
                          "maxItems": 20,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "lowerInclusive": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 2049,
                                    "pattern": "^-?(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 2048,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "upper": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 2049,
                                    "pattern": "^-?(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 2048,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "upperInclusive": {
                                "type": "boolean"
                              },
                              "predictionCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "labeledCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "positiveCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "meanProbability": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "observedRate": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "calibrationGap": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "index",
                              "lowerInclusive",
                              "upper",
                              "upperInclusive",
                              "predictionCount",
                              "labeledCount",
                              "positiveCount",
                              "meanProbability",
                              "observedRate",
                              "calibrationGap"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "predictions": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "binIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "squaredError": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "binIndex",
                              "squaredError"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "semanticValidityVerified",
                        "predictionCount",
                        "labeledCount",
                        "unknownOutcomeCount",
                        "complete",
                        "brierScore",
                        "expectedCalibrationError",
                        "maximumCalibrationGap",
                        "bins",
                        "predictions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "prediction-calibration-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "binary-probability-calibration-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "semanticValidityVerified": false,
                    "predictionCount": 3,
                    "labeledCount": 2,
                    "unknownOutcomeCount": 1,
                    "complete": false,
                    "brierScore": {
                      "numerator": "17",
                      "denominator": "50"
                    },
                    "expectedCalibrationError": {
                      "numerator": "3",
                      "denominator": "10"
                    },
                    "maximumCalibrationGap": {
                      "numerator": "3",
                      "denominator": "10"
                    },
                    "bins": [
                      {
                        "index": 0,
                        "lowerInclusive": {
                          "numerator": "0",
                          "denominator": "1"
                        },
                        "upper": {
                          "numerator": "1",
                          "denominator": "2"
                        },
                        "upperInclusive": false,
                        "predictionCount": 1,
                        "labeledCount": 0,
                        "positiveCount": 0,
                        "meanProbability": null,
                        "observedRate": null,
                        "calibrationGap": null
                      },
                      {
                        "index": 1,
                        "lowerInclusive": {
                          "numerator": "1",
                          "denominator": "2"
                        },
                        "upper": {
                          "numerator": "1",
                          "denominator": "1"
                        },
                        "upperInclusive": true,
                        "predictionCount": 2,
                        "labeledCount": 2,
                        "positiveCount": 1,
                        "meanProbability": {
                          "numerator": "4",
                          "denominator": "5"
                        },
                        "observedRate": {
                          "numerator": "1",
                          "denominator": "2"
                        },
                        "calibrationGap": {
                          "numerator": "3",
                          "denominator": "10"
                        }
                      }
                    ],
                    "predictions": [
                      {
                        "id": "case-1",
                        "binIndex": 1,
                        "squaredError": {
                          "numerator": "1",
                          "denominator": "25"
                        }
                      },
                      {
                        "id": "case-2",
                        "binIndex": 1,
                        "squaredError": {
                          "numerator": "16",
                          "denominator": "25"
                        }
                      },
                      {
                        "id": "case-3",
                        "binIndex": 0,
                        "squaredError": null
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "487d8a324ebc4d910aa27e48d5abb89bb0c16022113f707bc6dc6c321cde07b4",
                    "outputSha256": "ec152f997950d908cbe1a00982c312bab17bb2f591623e4872555689c6013503",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/record-profile": {
      "post": {
        "operationId": "mpp_record_profile",
        "summary": "Record field observations",
        "description": "Profile caller-selected JSON Pointer fields across up to 500 records: missing/null/type counts, typed distinct values, numeric bounds/median, UTF-16 string lengths and bounded duplicate-row evidence. Observations only; no inferred schema guarantee or population extrapolation.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/record-profile.md"
        },
        "x-agent-discovery": {
          "intents": [
            "profile missing null fields in JSON records",
            "inspect dataset types cardinality duplicates before validation",
            "measure field completeness and mixed types"
          ],
          "whenToUse": [
            "profile missing null fields in JSON records",
            "inspect dataset types cardinality duplicates before validation",
            "measure field completeness and mixed types"
          ],
          "whenNotToUse": [
            "Infer a guaranteed schema or population distribution",
            "Fuzzy entity matching or CSV file comparison"
          ],
          "capabilities": [
            "JSON Pointer field observations",
            "missing/null separation",
            "typed structural cardinality",
            "duplicate evidence",
            "numeric median"
          ],
          "related": [
            "record-constraints",
            "record-relations"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "records": 500,
            "fields": 32,
            "duplicateGroupsPerField": 5
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1record-profile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "fields": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 512,
                      "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                    }
                  }
                },
                "required": [
                  "records",
                  "fields"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1record-profile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1record-profile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "id": "a",
                    "price": 12,
                    "status": "ready"
                  },
                  {
                    "id": "b",
                    "price": null,
                    "status": "ready"
                  },
                  {
                    "id": "c",
                    "status": "new"
                  }
                ],
                "fields": [
                  "/price",
                  "/status"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "record-profile",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "record-observations-v1"
                        },
                        "rowCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "fields": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "presentCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "missingCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "nullCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "distinctCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "typeCounts": {
                                "type": "object",
                                "properties": {
                                  "null": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "boolean": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "number": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "string": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "array": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "object": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                },
                                "required": [
                                  "null",
                                  "boolean",
                                  "number",
                                  "string",
                                  "array",
                                  "object"
                                ],
                                "additionalProperties": false
                              },
                              "numeric": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "count": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "min": {
                                        "type": "number"
                                      },
                                      "max": {
                                        "type": "number"
                                      },
                                      "median": {
                                        "type": "number"
                                      }
                                    },
                                    "required": [
                                      "count",
                                      "min",
                                      "max",
                                      "median"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "stringLengthsUtf16": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "count": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "min": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "max": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "count",
                                      "min",
                                      "max"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "duplicateGroups": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "firstRowIndex": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "count": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "rowIndices": {
                                      "type": "array",
                                      "items": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "rowIndicesTruncated": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "firstRowIndex",
                                    "count",
                                    "rowIndices",
                                    "rowIndicesTruncated"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "duplicateGroupCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "duplicateGroupsTruncated": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "path",
                              "presentCount",
                              "missingCount",
                              "nullCount",
                              "distinctCount",
                              "typeCounts",
                              "numeric",
                              "stringLengthsUtf16",
                              "duplicateGroups",
                              "duplicateGroupCount",
                              "duplicateGroupsTruncated"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "caveats": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "rowCount",
                        "fields",
                        "caveats"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "record-profile",
                  "version": "0.29.0",
                  "result": {
                    "profile": "record-observations-v1",
                    "rowCount": 3,
                    "fields": [
                      {
                        "path": "/price",
                        "presentCount": 2,
                        "missingCount": 1,
                        "nullCount": 1,
                        "distinctCount": 2,
                        "typeCounts": {
                          "null": 1,
                          "boolean": 0,
                          "number": 1,
                          "string": 0,
                          "array": 0,
                          "object": 0
                        },
                        "numeric": {
                          "count": 1,
                          "min": 12,
                          "max": 12,
                          "median": 12
                        },
                        "stringLengthsUtf16": null,
                        "duplicateGroups": [],
                        "duplicateGroupCount": 0,
                        "duplicateGroupsTruncated": false
                      },
                      {
                        "path": "/status",
                        "presentCount": 3,
                        "missingCount": 0,
                        "nullCount": 0,
                        "distinctCount": 2,
                        "typeCounts": {
                          "null": 0,
                          "boolean": 0,
                          "number": 0,
                          "string": 3,
                          "array": 0,
                          "object": 0
                        },
                        "numeric": null,
                        "stringLengthsUtf16": {
                          "count": 3,
                          "min": 3,
                          "max": 5
                        },
                        "duplicateGroups": [
                          {
                            "firstRowIndex": 0,
                            "count": 2,
                            "rowIndices": [
                              0,
                              1
                            ],
                            "rowIndicesTruncated": false
                          }
                        ],
                        "duplicateGroupCount": 1,
                        "duplicateGroupsTruncated": false
                      }
                    ],
                    "caveats": [
                      "Observations describe only supplied rows, not a schema guarantee or population estimate.",
                      "Distinct values use typed structural JSON equality with object keys sorted; missing is separate from null. Numbers are already-parsed IEEE-754 values."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "7a3a2676a5c8b31f529bfb018adf6ce45a687787779349029dcae02ef5215fe9",
                    "outputSha256": "8135f48756dbce1bac61c230404690ca325e61c434d49d3b36c95903d7c4342d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/record-constraints": {
      "post": {
        "operationId": "mpp_record_constraints",
        "summary": "Declarative record constraints",
        "description": "Evaluate up to 40 bounded rules across 500 supplied records: presence, JSON type, inclusive numeric bounds, string/array length, typed allowed values and composite uniqueness. Returns per-rule counts and row-addressed violations. No expressions, regex or automatic repair.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/record-constraints.md"
        },
        "x-agent-discovery": {
          "intents": [
            "validate dataset quality rules and composite uniqueness",
            "find records violating required fields ranges enums lengths",
            "return machine-readable row violations for data quality gates"
          ],
          "whenToUse": [
            "validate dataset quality rules and composite uniqueness",
            "find records violating required fields ranges enums lengths",
            "return machine-readable row violations for data quality gates"
          ],
          "whenNotToUse": [
            "Arbitrary JSON Schema conformance",
            "Evaluate code SQL regex or repair data automatically"
          ],
          "capabilities": [
            "declarative data quality rules",
            "composite unique keys",
            "row-level violation evidence",
            "complete counts with bounded findings"
          ],
          "related": [
            "record-profile",
            "record-relations",
            "json-schema-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "records": 500,
            "rules": 40,
            "compositeFields": 5
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1record-constraints/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "rules": {
                    "minItems": 1,
                    "maxItems": 40,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "present"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 512,
                              "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                            },
                            "allowNull": {
                              "default": false,
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "path"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "type"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 512,
                              "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                            },
                            "type": {
                              "type": "string",
                              "enum": [
                                "string",
                                "number",
                                "integer",
                                "boolean",
                                "null",
                                "array",
                                "object"
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "path",
                            "type"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "number-range"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 512,
                              "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                            },
                            "min": {
                              "type": "number"
                            },
                            "max": {
                              "type": "number"
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "path"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "length"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 512,
                              "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                            },
                            "min": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "max": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "path"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "one-of"
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 512,
                              "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                            },
                            "values": {
                              "minItems": 1,
                              "maxItems": 50,
                              "type": "array",
                              "items": {
                                "type": [
                                  "string",
                                  "number",
                                  "boolean",
                                  "null"
                                ]
                              }
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "path",
                            "values"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 80
                            },
                            "kind": {
                              "type": "string",
                              "const": "unique"
                            },
                            "paths": {
                              "minItems": 1,
                              "maxItems": 5,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "maxLength": 512,
                                "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                              }
                            },
                            "missing": {
                              "default": "reject",
                              "type": "string",
                              "enum": [
                                "reject",
                                "ignore"
                              ]
                            },
                            "nulls": {
                              "default": "value",
                              "type": "string",
                              "enum": [
                                "value",
                                "ignore"
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "paths"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "records",
                  "rules"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1record-constraints/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1record-constraints/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "id": "a",
                    "score": 0.8
                  },
                  {
                    "id": "a",
                    "score": 1.2
                  },
                  {
                    "score": null
                  }
                ],
                "rules": [
                  {
                    "id": "id-required",
                    "kind": "present",
                    "path": "/id"
                  },
                  {
                    "id": "score-range",
                    "kind": "number-range",
                    "path": "/score",
                    "min": 0,
                    "max": 1
                  },
                  {
                    "id": "id-unique",
                    "kind": "unique",
                    "paths": [
                      "/id"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "record-constraints",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "record-constraints-v1"
                        },
                        "passes": {
                          "type": "boolean"
                        },
                        "rowCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "violationCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "rules": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "evaluatedCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "ignoredCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "violationCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "id",
                              "evaluatedCount",
                              "ignoredCount",
                              "violationCount"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "violations": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "rowIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "ruleId": {
                                "type": "string"
                              },
                              "relatedRowIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "code",
                              "rowIndex",
                              "path",
                              "message",
                              "ruleId",
                              "relatedRowIndex"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "caveats": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "passes",
                        "rowCount",
                        "violationCount",
                        "rules",
                        "violations",
                        "truncated",
                        "caveats"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "record-constraints",
                  "version": "0.29.0",
                  "result": {
                    "profile": "record-constraints-v1",
                    "passes": false,
                    "rowCount": 3,
                    "violationCount": 5,
                    "rules": [
                      {
                        "id": "id-required",
                        "evaluatedCount": 3,
                        "ignoredCount": 0,
                        "violationCount": 1
                      },
                      {
                        "id": "score-range",
                        "evaluatedCount": 3,
                        "ignoredCount": 0,
                        "violationCount": 2
                      },
                      {
                        "id": "id-unique",
                        "evaluatedCount": 3,
                        "ignoredCount": 0,
                        "violationCount": 2
                      }
                    ],
                    "violations": [
                      {
                        "code": "MISSING_VALUE",
                        "rowIndex": 2,
                        "path": "/id",
                        "message": "Field is absent",
                        "ruleId": "id-required",
                        "relatedRowIndex": null
                      },
                      {
                        "code": "OUT_OF_RANGE",
                        "rowIndex": 1,
                        "path": "/score",
                        "message": "Number is outside inclusive bounds",
                        "ruleId": "score-range",
                        "relatedRowIndex": null
                      },
                      {
                        "code": "TYPE_MISMATCH",
                        "rowIndex": 2,
                        "path": "/score",
                        "message": "Expected number; observed null",
                        "ruleId": "score-range",
                        "relatedRowIndex": null
                      },
                      {
                        "code": "DUPLICATE_VALUE",
                        "rowIndex": 1,
                        "path": "",
                        "message": "Composite key duplicates an earlier row",
                        "ruleId": "id-unique",
                        "relatedRowIndex": 0
                      },
                      {
                        "code": "MISSING_VALUE",
                        "rowIndex": 2,
                        "path": "",
                        "message": "A unique-key field is absent",
                        "ruleId": "id-unique",
                        "relatedRowIndex": null
                      }
                    ],
                    "truncated": false,
                    "caveats": [
                      "All rules are evaluated independently. Counts include findings beyond the retained evidence limit.",
                      "Unique violations identify each later duplicate and its first row; missing and null policies are explicit. String length uses UTF-16 code units."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "39ce3bc4f0e0760179cdc3f84efcab5402ccceee5fb13137750a1cf60d26e1b2",
                    "outputSha256": "d09e9b55481c864dbd6d0d45e910854e079e33edb7ea1599b9db64ab31ac8370",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/record-relations": {
      "post": {
        "operationId": "mpp_record_relations",
        "summary": "Record referential integrity",
        "description": "Check typed scalar composite foreign keys between supplied parent and child records. Reports orphan, invalid and ambiguous child links, duplicate parent keys, optional null-child skipping and unreferenced parent rows. No database connection, coercion or guessed matches.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/record-relations.md"
        },
        "x-agent-discovery": {
          "intents": [
            "validate foreign keys between supplied JSON tables",
            "find orphan child records and ambiguous duplicate parent keys",
            "check composite referential integrity without a database"
          ],
          "whenToUse": [
            "validate foreign keys between supplied JSON tables",
            "find orphan child records and ambiguous duplicate parent keys",
            "check composite referential integrity without a database"
          ],
          "whenNotToUse": [
            "Query or mutate a live database",
            "Fuzzy entity resolution or automatic record joins"
          ],
          "capabilities": [
            "typed scalar composite keys",
            "orphan and ambiguity evidence",
            "null child policy",
            "unreferenced parent inventory"
          ],
          "related": [
            "record-constraints",
            "record-profile"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "parents": 500,
            "children": 500,
            "compositeFields": 5,
            "retainedParentMatchesPerChild": 10
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "parents": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1record-relations/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "children": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1record-relations/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "parentKey": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 512,
                      "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                    }
                  },
                  "childKey": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 512,
                      "description": "RFC 6901 JSON string pointer; empty string selects the row root. URI fragments and unsafe property names are rejected."
                    }
                  },
                  "skipNullChildKeys": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "parents",
                  "children",
                  "parentKey",
                  "childKey"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1record-relations/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1record-relations/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "parents": [
                  {
                    "org": "north",
                    "id": "1"
                  },
                  {
                    "org": "south",
                    "id": "1"
                  }
                ],
                "children": [
                  {
                    "org": "north",
                    "owner": "1"
                  },
                  {
                    "org": "north",
                    "owner": "2"
                  }
                ],
                "parentKey": [
                  "/org",
                  "/id"
                ],
                "childKey": [
                  "/org",
                  "/owner"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "record-relations",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "record-relations-v1"
                        },
                        "passes": {
                          "type": "boolean"
                        },
                        "parentCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "childCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matchedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "orphanCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "ambiguousCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "invalidChildCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "skippedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "invalidParentCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "duplicateParentKeyCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "links": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "childRowIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "matched",
                                  "orphan",
                                  "ambiguous",
                                  "invalid",
                                  "skipped"
                                ]
                              },
                              "code": {
                                "type": "string"
                              },
                              "parentRowIndices": {
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "parentMatchCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "parentRowIndicesTruncated": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "childRowIndex",
                              "status",
                              "code",
                              "parentRowIndices",
                              "parentMatchCount",
                              "parentRowIndicesTruncated"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "parentFindings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "rowIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "rowIndex",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "parentFindingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "parentFindingsTruncated": {
                          "type": "boolean"
                        },
                        "unreferencedValidParentRowIndices": {
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          }
                        },
                        "caveats": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "passes",
                        "parentCount",
                        "childCount",
                        "matchedCount",
                        "orphanCount",
                        "ambiguousCount",
                        "invalidChildCount",
                        "skippedCount",
                        "invalidParentCount",
                        "duplicateParentKeyCount",
                        "links",
                        "parentFindings",
                        "parentFindingCount",
                        "parentFindingsTruncated",
                        "unreferencedValidParentRowIndices",
                        "caveats"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "record-relations",
                  "version": "0.29.0",
                  "result": {
                    "profile": "record-relations-v1",
                    "passes": false,
                    "parentCount": 2,
                    "childCount": 2,
                    "matchedCount": 1,
                    "orphanCount": 1,
                    "ambiguousCount": 0,
                    "invalidChildCount": 0,
                    "skippedCount": 0,
                    "invalidParentCount": 0,
                    "duplicateParentKeyCount": 0,
                    "links": [
                      {
                        "childRowIndex": 0,
                        "status": "matched",
                        "code": "MATCHED",
                        "parentRowIndices": [
                          0
                        ],
                        "parentMatchCount": 1,
                        "parentRowIndicesTruncated": false
                      },
                      {
                        "childRowIndex": 1,
                        "status": "orphan",
                        "code": "MISSING_PARENT",
                        "parentRowIndices": [],
                        "parentMatchCount": 0,
                        "parentRowIndicesTruncated": false
                      }
                    ],
                    "parentFindings": [],
                    "parentFindingCount": 0,
                    "parentFindingsTruncated": false,
                    "unreferencedValidParentRowIndices": [
                      1
                    ],
                    "caveats": [
                      "Keys are typed scalar tuples; strings and numbers do not coerce. Parent null/missing/compound values are invalid.",
                      "Optional null-child skipping applies when any key field is null and none is missing. Ambiguous parent groups are never resolved to one row; unreferenced excludes every key matched by a child."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "8fc788220443d087baf6612349f0c395ee9ad57881ce107eb27503fabc482719",
                    "outputSha256": "bc441d2b05b7334c8dd22b5714bf451db766fb87868b2fd8e62f2e5c495d30ea",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/classification-evaluate": {
      "post": {
        "operationId": "mpp_classification_evaluate",
        "summary": "Classification evaluation evidence",
        "description": "Evaluate up to 1,000 caller-supplied single-label expected/predicted pairs: confusion matrix, per-label precision/recall/F1/support, macro/weighted/micro summaries, balanced accuracy and mismatch evidence. Undefined per-label values use zero with explicit flags; labels are not verified ground truth.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/classification-evaluate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "calculate confusion matrix precision recall f1 from evaluation labels",
            "score agent routing classification predictions against supplied labels",
            "inspect macro micro weighted metrics and error samples"
          ],
          "whenToUse": [
            "calculate confusion matrix precision recall f1 from evaluation labels",
            "score agent routing classification predictions against supplied labels",
            "inspect macro micro weighted metrics and error samples"
          ],
          "whenNotToUse": [
            "Train or execute a model or infer factual ground truth",
            "Multilabel classification probability calibration or deployment certification"
          ],
          "capabilities": [
            "single-label classification metrics",
            "confusion matrix evidence",
            "undefined metric flags",
            "bounded mismatch samples"
          ],
          "related": [
            "ranking-evaluate",
            "span-evaluate"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "samples": 1000,
            "labels": 50
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "samples": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "expected": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "predicted": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "id",
                        "expected",
                        "predicted"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "labels": {
                    "default": [],
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 80
                    }
                  }
                },
                "required": [
                  "samples"
                ],
                "additionalProperties": false
              },
              "example": {
                "samples": [
                  {
                    "id": "e1",
                    "expected": "answer",
                    "predicted": "answer"
                  },
                  {
                    "id": "e2",
                    "expected": "abstain",
                    "predicted": "answer"
                  },
                  {
                    "id": "e3",
                    "expected": "abstain",
                    "predicted": "abstain"
                  }
                ],
                "labels": [
                  "answer",
                  "abstain"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "classification-evaluate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "single-label-evaluation-v1"
                        },
                        "sampleCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "labels": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "confusionMatrix": {
                          "type": "array",
                          "items": {
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          }
                        },
                        "perLabel": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "precision": {
                                "type": "number"
                              },
                              "recall": {
                                "type": "number"
                              },
                              "f1": {
                                "type": "number"
                              },
                              "label": {
                                "type": "string"
                              },
                              "truePositive": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "falsePositive": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "falseNegative": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "support": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "predictedCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "precisionDefined": {
                                "type": "boolean"
                              },
                              "recallDefined": {
                                "type": "boolean"
                              },
                              "f1Defined": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "precision",
                              "recall",
                              "f1",
                              "label",
                              "truePositive",
                              "falsePositive",
                              "falseNegative",
                              "support",
                              "predictedCount",
                              "precisionDefined",
                              "recallDefined",
                              "f1Defined"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "accuracy": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "balancedAccuracy": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "macro": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "precision": {
                                  "type": "number"
                                },
                                "recall": {
                                  "type": "number"
                                },
                                "f1": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "precision",
                                "recall",
                                "f1"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "weighted": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "precision": {
                                  "type": "number"
                                },
                                "recall": {
                                  "type": "number"
                                },
                                "f1": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "precision",
                                "recall",
                                "f1"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "micro": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "precision": {
                                  "type": "number"
                                },
                                "recall": {
                                  "type": "number"
                                },
                                "f1": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "precision",
                                "recall",
                                "f1"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "mismatchCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "mismatches": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "expected": {
                                "type": "string"
                              },
                              "predicted": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "expected",
                              "predicted"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "mismatchesTruncated": {
                          "type": "boolean"
                        },
                        "conventions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "sampleCount",
                        "labels",
                        "confusionMatrix",
                        "perLabel",
                        "accuracy",
                        "balancedAccuracy",
                        "macro",
                        "weighted",
                        "micro",
                        "mismatchCount",
                        "mismatches",
                        "mismatchesTruncated",
                        "conventions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "classification-evaluate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "single-label-evaluation-v1",
                    "sampleCount": 3,
                    "labels": [
                      "abstain",
                      "answer"
                    ],
                    "confusionMatrix": [
                      [
                        1,
                        1
                      ],
                      [
                        0,
                        1
                      ]
                    ],
                    "perLabel": [
                      {
                        "precision": 1,
                        "recall": 0.5,
                        "f1": 0.6666666666666666,
                        "label": "abstain",
                        "truePositive": 1,
                        "falsePositive": 0,
                        "falseNegative": 1,
                        "support": 2,
                        "predictedCount": 1,
                        "precisionDefined": true,
                        "recallDefined": true,
                        "f1Defined": true
                      },
                      {
                        "precision": 0.5,
                        "recall": 1,
                        "f1": 0.6666666666666666,
                        "label": "answer",
                        "truePositive": 1,
                        "falsePositive": 1,
                        "falseNegative": 0,
                        "support": 1,
                        "predictedCount": 2,
                        "precisionDefined": true,
                        "recallDefined": true,
                        "f1Defined": true
                      }
                    ],
                    "accuracy": 0.6666666666666666,
                    "balancedAccuracy": 0.75,
                    "macro": {
                      "precision": 0.75,
                      "recall": 0.75,
                      "f1": 0.6666666666666666
                    },
                    "weighted": {
                      "precision": 0.8333333333333334,
                      "recall": 0.6666666666666666,
                      "f1": 0.6666666666666666
                    },
                    "micro": {
                      "precision": 0.6666666666666666,
                      "recall": 0.6666666666666666,
                      "f1": 0.6666666666666666
                    },
                    "mismatchCount": 1,
                    "mismatches": [
                      {
                        "id": "e2",
                        "expected": "abstain",
                        "predicted": "answer"
                      }
                    ],
                    "mismatchesTruncated": false,
                    "conventions": [
                      "Confusion matrix rows are expected labels and columns are predicted labels; labels use code-unit lexical order.",
                      "Undefined per-label precision, recall or F1 is 0 with explicit defined flags. Macro includes all declared and observed labels; weighted uses expected support; balanced accuracy includes only supported labels.",
                      "Supplied expectations are not verified. No training, probability calibration, multilabel matching or inference about deployment quality."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "94e0ebdf6418835b5e24379c85e0dcf742165925f5cc787097b124279db65c32",
                    "outputSha256": "96304c42a7fa68f16782023dec0075af56722a1a75d391c578fcedb286492dc3",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/ranking-evaluate": {
      "post": {
        "operationId": "mpp_ranking_evaluate",
        "summary": "Supplied ranking evaluation",
        "description": "Score ranked document IDs against caller-supplied graded judgments for up to 50 queries: precision/recall, reciprocal rank, truncated average precision and NDCG at k. Explicit gain, unjudged and zero-denominator conventions; evidence lists ranked judgments and missed relevant IDs. No search or relevance inference.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/ranking-evaluate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "evaluate retrieval ranking ndcg map mrr precision recall at k",
            "score search results against supplied relevance judgments",
            "compare RAG retrieval quality using judged document ids"
          ],
          "whenToUse": [
            "evaluate retrieval ranking ndcg map mrr precision recall at k",
            "score search results against supplied relevance judgments",
            "compare RAG retrieval quality using judged document ids"
          ],
          "whenNotToUse": [
            "Search the web or determine semantic document relevance",
            "Claim benchmark completeness from partial judgments"
          ],
          "capabilities": [
            "graded ranking metrics",
            "explicit unjudged handling",
            "linear or exponential gain",
            "query-level metric evidence"
          ],
          "related": [
            "classification-evaluate",
            "span-evaluate"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "queries": 50,
            "retrievedPerQuery": 100,
            "judgmentsPerQuery": 100,
            "maximumK": 100
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "queries": {
                    "minItems": 1,
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "retrieved": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 80
                          }
                        },
                        "judgments": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "grade": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 10
                              }
                            },
                            "required": [
                              "id",
                              "grade"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "retrieved",
                        "judgments"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "k": {
                    "default": 10,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "relevantAtLeast": {
                    "default": 1,
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 10
                  },
                  "gain": {
                    "default": "linear",
                    "type": "string",
                    "enum": [
                      "linear",
                      "exponential"
                    ]
                  },
                  "unjudged": {
                    "default": "error",
                    "type": "string",
                    "enum": [
                      "error",
                      "nonrelevant"
                    ]
                  }
                },
                "required": [
                  "queries"
                ],
                "additionalProperties": false
              },
              "example": {
                "queries": [
                  {
                    "id": "q1",
                    "retrieved": [
                      "b",
                      "a",
                      "c"
                    ],
                    "judgments": [
                      {
                        "id": "a",
                        "grade": 3
                      },
                      {
                        "id": "b",
                        "grade": 1
                      },
                      {
                        "id": "c",
                        "grade": 0
                      },
                      {
                        "id": "d",
                        "grade": 2
                      }
                    ]
                  }
                ],
                "k": 3
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "ranking-evaluate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "supplied-ranking-evaluation-v1"
                        },
                        "k": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "queryCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "queries": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "precisionAtK": {
                                "type": "number"
                              },
                              "recallAtK": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "reciprocalRankAtK": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "averagePrecisionAtK": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "ndcgAtK": {
                                "type": [
                                  "number",
                                  "null"
                                ]
                              },
                              "id": {
                                "type": "string"
                              },
                              "relevantJudgmentCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "retrievedAtKCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "hitsAtK": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "unjudgedAtKCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "dcgAtK": {
                                "type": "number"
                              },
                              "idealDcgAtK": {
                                "type": "number"
                              },
                              "missedRelevantIds": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "ranking": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "rank": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "id": {
                                      "type": "string"
                                    },
                                    "grade": {
                                      "type": [
                                        "number",
                                        "null"
                                      ]
                                    },
                                    "relevant": {
                                      "type": "boolean"
                                    },
                                    "judged": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "rank",
                                    "id",
                                    "grade",
                                    "relevant",
                                    "judged"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "precisionAtK",
                              "recallAtK",
                              "reciprocalRankAtK",
                              "averagePrecisionAtK",
                              "ndcgAtK",
                              "id",
                              "relevantJudgmentCount",
                              "retrievedAtKCount",
                              "hitsAtK",
                              "unjudgedAtKCount",
                              "dcgAtK",
                              "idealDcgAtK",
                              "missedRelevantIds",
                              "ranking"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "macro": {
                          "type": "object",
                          "properties": {
                            "precisionAtK": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "recallAtK": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "reciprocalRankAtK": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "averagePrecisionAtK": {
                              "type": [
                                "number",
                                "null"
                              ]
                            },
                            "ndcgAtK": {
                              "type": [
                                "number",
                                "null"
                              ]
                            }
                          },
                          "required": [
                            "precisionAtK",
                            "recallAtK",
                            "reciprocalRankAtK",
                            "averagePrecisionAtK",
                            "ndcgAtK"
                          ],
                          "additionalProperties": false
                        },
                        "definedQueryCounts": {
                          "type": "object",
                          "properties": {
                            "precisionAtK": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "recallAtK": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "reciprocalRankAtK": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "averagePrecisionAtK": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "ndcgAtK": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "precisionAtK",
                            "recallAtK",
                            "reciprocalRankAtK",
                            "averagePrecisionAtK",
                            "ndcgAtK"
                          ],
                          "additionalProperties": false
                        },
                        "conventions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "k",
                        "queryCount",
                        "queries",
                        "macro",
                        "definedQueryCounts",
                        "conventions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "ranking-evaluate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "supplied-ranking-evaluation-v1",
                    "k": 3,
                    "queryCount": 1,
                    "queries": [
                      {
                        "precisionAtK": 0.6666666666666666,
                        "recallAtK": 0.6666666666666666,
                        "reciprocalRankAtK": 1,
                        "averagePrecisionAtK": 0.6666666666666666,
                        "ndcgAtK": 0.6074915180456525,
                        "id": "q1",
                        "relevantJudgmentCount": 3,
                        "retrievedAtKCount": 3,
                        "hitsAtK": 2,
                        "unjudgedAtKCount": 0,
                        "dcgAtK": 2.8927892607143724,
                        "idealDcgAtK": 4.7618595071429155,
                        "missedRelevantIds": [
                          "d"
                        ],
                        "ranking": [
                          {
                            "rank": 1,
                            "id": "b",
                            "grade": 1,
                            "relevant": true,
                            "judged": true
                          },
                          {
                            "rank": 2,
                            "id": "a",
                            "grade": 3,
                            "relevant": true,
                            "judged": true
                          },
                          {
                            "rank": 3,
                            "id": "c",
                            "grade": 0,
                            "relevant": false,
                            "judged": true
                          }
                        ]
                      }
                    ],
                    "macro": {
                      "precisionAtK": 0.6666666666666666,
                      "recallAtK": 0.6666666666666666,
                      "reciprocalRankAtK": 1,
                      "averagePrecisionAtK": 0.6666666666666666,
                      "ndcgAtK": 0.6074915180456525
                    },
                    "definedQueryCounts": {
                      "precisionAtK": 1,
                      "recallAtK": 1,
                      "reciprocalRankAtK": 1,
                      "averagePrecisionAtK": 1,
                      "ndcgAtK": 1
                    },
                    "conventions": [
                      "Precision denominator is k even when fewer results are supplied. Recall and truncated AP denominators use all supplied relevant judgments; reciprocal rank is truncated at k.",
                      "DCG uses linear gain and log2(rank + 1) discount. Ideal DCG uses all supplied judgments sorted by grade, truncated at k.",
                      "No-relevant-judgment recall, reciprocal rank and AP are null; zero-ideal-gain NDCG is null. Macro averages exclude nulls and report denominators.",
                      "Evaluation uses supplied judgments only. It does not retrieve documents, judge semantic relevance, or establish complete relevance coverage."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "a830c056a36bdf25d24ce65b0f72f06975f4ac98f7a9cb4aa70c79f3c3fd8b4f",
                    "outputSha256": "948595d1d37750d1e18558475116ee9dd440ddde396ae7edc49b7d9f909ac4d0",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/span-evaluate": {
      "post": {
        "operationId": "mpp_span_evaluate",
        "summary": "Annotation span evaluation",
        "description": "Evaluate supplied labeled text spans with exact boundaries or thresholded intersection-over-union. Bounded deterministic maximum-cardinality one-to-one matching returns precision/recall/F1, matches and unmatched IDs. UTF-16 half-open offsets are validated; labels and text meaning are not judged.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/span-evaluate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "evaluate named entity extraction annotation spans",
            "match predicted and reference text spans using exact offsets or iou",
            "calculate one-to-one span precision recall and unmatched evidence"
          ],
          "whenToUse": [
            "evaluate named entity extraction annotation spans",
            "match predicted and reference text spans using exact offsets or iou",
            "calculate one-to-one span precision recall and unmatched evidence"
          ],
          "whenNotToUse": [
            "Semantic factuality or entailment checking",
            "Tokenization byte offsets or globally maximum total IoU matching"
          ],
          "capabilities": [
            "exact or overlap span evaluation",
            "maximum-cardinality matching",
            "surrogate-safe UTF-16 boundaries",
            "per-label metrics and unmatched evidence"
          ],
          "related": [
            "classification-evaluate",
            "evidence-quote-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "textUtf16Units": 50000,
            "references": 100,
            "predictions": 100
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 50000
                  },
                  "references": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "label": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "id",
                        "label",
                        "start",
                        "end"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "predictions": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "label": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "id",
                        "label",
                        "start",
                        "end"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "match": {
                    "default": "exact",
                    "type": "string",
                    "enum": [
                      "exact",
                      "overlap"
                    ]
                  },
                  "minimumIou": {
                    "default": 0.5,
                    "type": "number",
                    "exclusiveMinimum": 0,
                    "maximum": 1
                  }
                },
                "required": [
                  "text",
                  "references",
                  "predictions"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Ada builds agents in London.",
                "references": [
                  {
                    "id": "r1",
                    "label": "person",
                    "start": 0,
                    "end": 3
                  },
                  {
                    "id": "r2",
                    "label": "place",
                    "start": 21,
                    "end": 27
                  }
                ],
                "predictions": [
                  {
                    "id": "p1",
                    "label": "person",
                    "start": 0,
                    "end": 3
                  },
                  {
                    "id": "p2",
                    "label": "place",
                    "start": 21,
                    "end": 26
                  }
                ],
                "match": "overlap",
                "minimumIou": 0.8
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "span-evaluate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "annotation-span-evaluation-v1"
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "utf16-code-unit"
                        },
                        "referenceCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "predictionCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matchedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "precision": {
                          "type": "number"
                        },
                        "recall": {
                          "type": "number"
                        },
                        "f1": {
                          "type": "number"
                        },
                        "precisionDefined": {
                          "type": "boolean"
                        },
                        "recallDefined": {
                          "type": "boolean"
                        },
                        "meanMatchedIou": {
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "matches": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "predictionId": {
                                "type": "string"
                              },
                              "referenceId": {
                                "type": "string"
                              },
                              "label": {
                                "type": "string"
                              },
                              "iou": {
                                "type": "number"
                              },
                              "exactBoundaries": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "predictionId",
                              "referenceId",
                              "label",
                              "iou",
                              "exactBoundaries"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "unmatchedPredictionIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "unmatchedReferenceIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "perLabel": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "label": {
                                "type": "string"
                              },
                              "referenceCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "predictionCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "matchedCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "precision": {
                                "type": "number"
                              },
                              "recall": {
                                "type": "number"
                              },
                              "f1": {
                                "type": "number"
                              }
                            },
                            "required": [
                              "label",
                              "referenceCount",
                              "predictionCount",
                              "matchedCount",
                              "precision",
                              "recall",
                              "f1"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "conventions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "offsetUnit",
                        "referenceCount",
                        "predictionCount",
                        "matchedCount",
                        "precision",
                        "recall",
                        "f1",
                        "precisionDefined",
                        "recallDefined",
                        "meanMatchedIou",
                        "matches",
                        "unmatchedPredictionIds",
                        "unmatchedReferenceIds",
                        "perLabel",
                        "conventions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "span-evaluate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "annotation-span-evaluation-v1",
                    "offsetUnit": "utf16-code-unit",
                    "referenceCount": 2,
                    "predictionCount": 2,
                    "matchedCount": 2,
                    "precision": 1,
                    "recall": 1,
                    "f1": 1,
                    "precisionDefined": true,
                    "recallDefined": true,
                    "meanMatchedIou": 0.9166666666666667,
                    "matches": [
                      {
                        "predictionId": "p1",
                        "referenceId": "r1",
                        "label": "person",
                        "iou": 1,
                        "exactBoundaries": true
                      },
                      {
                        "predictionId": "p2",
                        "referenceId": "r2",
                        "label": "place",
                        "iou": 0.8333333333333334,
                        "exactBoundaries": false
                      }
                    ],
                    "unmatchedPredictionIds": [],
                    "unmatchedReferenceIds": [],
                    "perLabel": [
                      {
                        "label": "person",
                        "referenceCount": 1,
                        "predictionCount": 1,
                        "matchedCount": 1,
                        "precision": 1,
                        "recall": 1,
                        "f1": 1
                      },
                      {
                        "label": "place",
                        "referenceCount": 1,
                        "predictionCount": 1,
                        "matchedCount": 1,
                        "precision": 1,
                        "recall": 1,
                        "f1": 1
                      }
                    ],
                    "conventions": [
                      "Spans are nonempty half-open UTF-16 code-unit ranges; surrogate pairs cannot be split. Labels match exactly. Repeated label/boundary spans on the same side are rejected.",
                      "Matching maximizes one-to-one pair count. Deterministic ID order and local IoU preference break ties; total IoU is not globally maximized.",
                      "Undefined precision/recall/F1 uses 0. This evaluates supplied annotations and boundaries, not the truth or meaning of their labels."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "17fd96b5568ac2fb16fcbdb52e9741bfa919234807e289f37c7ea47b30710f28",
                    "outputSha256": "69f28072bd7f33501f9d2566743476fd9024f8437868687e435fa8156ff5c4f1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/time-series-inspect": {
      "post": {
        "operationId": "mpp_time_series_inspect",
        "summary": "Time-series cadence inspection",
        "description": "Inspect up to 1,000 supplied timestamp/value points for ordering, duplicate timestamps, null values and optional cadence deviations. Returns bounded interval evidence, aligned missing-point estimates and descriptive numeric summaries. No clock, interpolation, anomaly prediction or forecasting.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/time-series-inspect.md"
        },
        "x-agent-discovery": {
          "intents": [
            "inspect time series cadence gaps duplicate timestamps and null readings",
            "validate chronological telemetry points before analysis",
            "find irregular intervals and missing observations in supplied data"
          ],
          "whenToUse": [
            "inspect time series cadence gaps duplicate timestamps and null readings",
            "validate chronological telemetry points before analysis",
            "find irregular intervals and missing observations in supplied data"
          ],
          "whenNotToUse": [
            "Forecast prices predict anomalies or make trading decisions",
            "Fetch live telemetry or infer wall-clock freshness"
          ],
          "capabilities": [
            "chronological ordering evidence",
            "duplicate timestamp groups",
            "cadence deviation evidence",
            "bounded descriptive summaries"
          ],
          "related": [
            "interval-analyze",
            "timestamp-convert"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "points": 1000,
            "timestampUnit": "Unix milliseconds",
            "numericAbsoluteMaximum": 1e+100
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "points": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "timeMs": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 8640000000000000
                        },
                        "value": {
                          "anyOf": [
                            {
                              "type": "number",
                              "minimum": -1e+100,
                              "maximum": 1e+100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "timeMs",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "expectedStepMs": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 8640000000000000
                  },
                  "toleranceMs": {
                    "default": 0,
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 8640000000000000
                  }
                },
                "required": [
                  "points"
                ],
                "additionalProperties": false
              },
              "example": {
                "points": [
                  {
                    "timeMs": 0,
                    "value": 10
                  },
                  {
                    "timeMs": 1000,
                    "value": 12
                  },
                  {
                    "timeMs": 3000,
                    "value": null
                  },
                  {
                    "timeMs": 1000,
                    "value": 11
                  }
                ],
                "expectedStepMs": 1000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "time-series-inspect",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "time-series-inspection-v1"
                        },
                        "pointCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "distinctTimestampCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "nullValueCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "firstTimeMs": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 8640000000000000
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "lastTimeMs": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 8640000000000000
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "sortedInput": {
                          "type": "boolean"
                        },
                        "outOfOrderPairCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "outOfOrderPairs": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "previousRowIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "rowIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "previousTimeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8640000000000000
                              },
                              "timeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8640000000000000
                              }
                            },
                            "required": [
                              "previousRowIndex",
                              "rowIndex",
                              "previousTimeMs",
                              "timeMs"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "outOfOrderPairsTruncated": {
                          "type": "boolean"
                        },
                        "duplicateTimestampCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "duplicateTimestamps": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "timeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8640000000000000
                              },
                              "count": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "rowIndices": {
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "rowIndicesTruncated": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "timeMs",
                              "count",
                              "rowIndices",
                              "rowIndicesTruncated"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "duplicateTimestampsTruncated": {
                          "type": "boolean"
                        },
                        "cadenceChecked": {
                          "type": "boolean"
                        },
                        "irregularIntervalCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "irregularIntervals": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "fromTimeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8640000000000000
                              },
                              "toTimeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8640000000000000
                              },
                              "deltaMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "short",
                                  "long"
                                ]
                              },
                              "inferredMissingPoints": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "fromTimeMs",
                              "toTimeMs",
                              "deltaMs",
                              "kind",
                              "inferredMissingPoints"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "irregularIntervalsTruncated": {
                          "type": "boolean"
                        },
                        "numeric": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "count": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "min": {
                                  "type": "number"
                                },
                                "max": {
                                  "type": "number"
                                },
                                "mean": {
                                  "type": "number"
                                },
                                "median": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "count",
                                "min",
                                "max",
                                "mean",
                                "median"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "conventions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "pointCount",
                        "distinctTimestampCount",
                        "nullValueCount",
                        "firstTimeMs",
                        "lastTimeMs",
                        "sortedInput",
                        "outOfOrderPairCount",
                        "outOfOrderPairs",
                        "outOfOrderPairsTruncated",
                        "duplicateTimestampCount",
                        "duplicateTimestamps",
                        "duplicateTimestampsTruncated",
                        "cadenceChecked",
                        "irregularIntervalCount",
                        "irregularIntervals",
                        "irregularIntervalsTruncated",
                        "numeric",
                        "conventions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "time-series-inspect",
                  "version": "0.29.0",
                  "result": {
                    "profile": "time-series-inspection-v1",
                    "pointCount": 4,
                    "distinctTimestampCount": 3,
                    "nullValueCount": 1,
                    "firstTimeMs": 0,
                    "lastTimeMs": 3000,
                    "sortedInput": false,
                    "outOfOrderPairCount": 1,
                    "outOfOrderPairs": [
                      {
                        "previousRowIndex": 2,
                        "rowIndex": 3,
                        "previousTimeMs": 3000,
                        "timeMs": 1000
                      }
                    ],
                    "outOfOrderPairsTruncated": false,
                    "duplicateTimestampCount": 1,
                    "duplicateTimestamps": [
                      {
                        "timeMs": 1000,
                        "count": 2,
                        "rowIndices": [
                          1,
                          3
                        ],
                        "rowIndicesTruncated": false
                      }
                    ],
                    "duplicateTimestampsTruncated": false,
                    "cadenceChecked": true,
                    "irregularIntervalCount": 1,
                    "irregularIntervals": [
                      {
                        "fromTimeMs": 1000,
                        "toTimeMs": 3000,
                        "deltaMs": 2000,
                        "kind": "long",
                        "inferredMissingPoints": 1
                      }
                    ],
                    "irregularIntervalsTruncated": false,
                    "numeric": {
                      "count": 3,
                      "min": 10,
                      "max": 12,
                      "mean": 11,
                      "median": 11
                    },
                    "conventions": [
                      "Timestamps are supplied Unix milliseconds. Cadence checks adjacent distinct sorted timestamps, not absolute grid phase or wall-clock freshness.",
                      "Missing-point counts are inferred only when a long interval is within tolerance of an integer step multiple. Other irregular intervals return null; no data is imputed.",
                      "Numeric summary includes every non-null supplied value, including duplicate timestamps. Statistics use IEEE-754 arithmetic and do not establish a forecast or anomaly cause."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "9e9f6fa86c25c41d24fc6a75e6b1ecb1eac14ad7773de1b2ed73918897510926",
                    "outputSha256": "7aa0ada91ec76f7c1cbe2f504d5a66b00d27da27f68aae4e128228d1a1ff0b99",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/interval-analyze": {
      "post": {
        "operationId": "mpp_interval_analyze",
        "summary": "Interval coverage and overlaps",
        "description": "Analyze up to 300 integer half-open intervals inside an explicit window: clipped union, gaps, covered/multiply-covered duration, concurrency segments and overlap-pair evidence. Touching endpoints do not overlap. No calendar access, reservations or scheduling actions.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/interval-analyze.md"
        },
        "x-agent-discovery": {
          "intents": [
            "calculate interval coverage union gaps overlaps and concurrency",
            "inspect execution windows for overlaps and uncovered time",
            "find coverage gaps in supplied numeric ranges"
          ],
          "whenToUse": [
            "calculate interval coverage union gaps overlaps and concurrency",
            "inspect execution windows for overlaps and uncovered time",
            "find coverage gaps in supplied numeric ranges"
          ],
          "whenNotToUse": [
            "Book meetings mutate calendars or schedule execution",
            "Interpret timezone recurrences or continuous noninteger geometry"
          ],
          "capabilities": [
            "half-open interval union",
            "window clipping and gap analysis",
            "maximum concurrency",
            "complete overlap counts with bounded evidence"
          ],
          "related": [
            "time-series-inspect",
            "workflow-dag-analyze"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "evidence": 200,
            "keyWorkBytes": 3000000,
            "matchingSteps": 2000000,
            "intervals": 300,
            "endpointAbsoluteMaximum": 1000000000000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_NUMBER",
            "INVALID_POINTER",
            "DUPLICATE_ID",
            "DUPLICATE_FIELD",
            "INVALID_RULE",
            "KEY_WORK_LIMIT",
            "LABEL_LIMIT",
            "UNJUDGED_DOCUMENT",
            "INVALID_SPAN",
            "DUPLICATE_SPAN",
            "INVALID_UNICODE",
            "MATCHING_LIMIT",
            "INVALID_CADENCE",
            "INVALID_INTERVAL",
            "NUMERIC_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "window": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "integer",
                        "minimum": -1000000000000,
                        "maximum": 1000000000000
                      },
                      "end": {
                        "type": "integer",
                        "minimum": -1000000000000,
                        "maximum": 1000000000000
                      }
                    },
                    "required": [
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  },
                  "intervals": {
                    "maxItems": 300,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "start": {
                          "type": "integer",
                          "minimum": -1000000000000,
                          "maximum": 1000000000000
                        },
                        "end": {
                          "type": "integer",
                          "minimum": -1000000000000,
                          "maximum": 1000000000000
                        },
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        }
                      },
                      "required": [
                        "start",
                        "end",
                        "id"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "unit": {
                    "default": "units",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 40
                  }
                },
                "required": [
                  "window",
                  "intervals"
                ],
                "additionalProperties": false
              },
              "example": {
                "window": {
                  "start": 0,
                  "end": 20
                },
                "intervals": [
                  {
                    "id": "a",
                    "start": 2,
                    "end": 8
                  },
                  {
                    "id": "b",
                    "start": 6,
                    "end": 12
                  },
                  {
                    "id": "c",
                    "start": 15,
                    "end": 25
                  }
                ],
                "unit": "seconds"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "interval-analyze",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "half-open-intervals-v1"
                        },
                        "unit": {
                          "type": "string"
                        },
                        "window": {
                          "type": "object",
                          "properties": {
                            "start": {
                              "type": "integer",
                              "minimum": -1000000000000,
                              "maximum": 1000000000000
                            },
                            "end": {
                              "type": "integer",
                              "minimum": -1000000000000,
                              "maximum": 1000000000000
                            }
                          },
                          "required": [
                            "start",
                            "end"
                          ],
                          "additionalProperties": false
                        },
                        "intervalCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "consideredCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "outsideWindowIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "clippedIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "coveredDuration": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "uncoveredDuration": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "multiplyCoveredDuration": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "maximumConcurrency": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "coverage": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "activeCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "activeCount"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "union": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "gaps": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "overlappingPairCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "overlappingPairs": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": -1000000000000,
                                "maximum": 1000000000000
                              },
                              "leftId": {
                                "type": "string"
                              },
                              "rightId": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "leftId",
                              "rightId"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "overlappingPairsTruncated": {
                          "type": "boolean"
                        },
                        "conventions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "unit",
                        "window",
                        "intervalCount",
                        "consideredCount",
                        "outsideWindowIds",
                        "clippedIds",
                        "coveredDuration",
                        "uncoveredDuration",
                        "multiplyCoveredDuration",
                        "maximumConcurrency",
                        "coverage",
                        "union",
                        "gaps",
                        "overlappingPairCount",
                        "overlappingPairs",
                        "overlappingPairsTruncated",
                        "conventions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "interval-analyze",
                  "version": "0.29.0",
                  "result": {
                    "profile": "half-open-intervals-v1",
                    "unit": "seconds",
                    "window": {
                      "start": 0,
                      "end": 20
                    },
                    "intervalCount": 3,
                    "consideredCount": 3,
                    "outsideWindowIds": [],
                    "clippedIds": [
                      "c"
                    ],
                    "coveredDuration": 15,
                    "uncoveredDuration": 5,
                    "multiplyCoveredDuration": 2,
                    "maximumConcurrency": 2,
                    "coverage": [
                      {
                        "start": 0,
                        "end": 2,
                        "activeCount": 0
                      },
                      {
                        "start": 2,
                        "end": 6,
                        "activeCount": 1
                      },
                      {
                        "start": 6,
                        "end": 8,
                        "activeCount": 2
                      },
                      {
                        "start": 8,
                        "end": 12,
                        "activeCount": 1
                      },
                      {
                        "start": 12,
                        "end": 15,
                        "activeCount": 0
                      },
                      {
                        "start": 15,
                        "end": 20,
                        "activeCount": 1
                      }
                    ],
                    "union": [
                      {
                        "start": 2,
                        "end": 12
                      },
                      {
                        "start": 15,
                        "end": 20
                      }
                    ],
                    "gaps": [
                      {
                        "start": 0,
                        "end": 2
                      },
                      {
                        "start": 12,
                        "end": 15
                      }
                    ],
                    "overlappingPairCount": 1,
                    "overlappingPairs": [
                      {
                        "start": 6,
                        "end": 8,
                        "leftId": "a",
                        "rightId": "b"
                      }
                    ],
                    "overlappingPairsTruncated": false,
                    "conventions": [
                      "All intervals are half-open [start,end); touching endpoints do not overlap. Results are clipped to the explicit window.",
                      "Coverage segments represent active counts, not interval identity. Pair counts include every overlap even when retained evidence is truncated. Units are caller-declared; no scheduling action is performed."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "14a28f54ff2cc9b8b24efc58e227f8ab3e1961948d1cac7ce9eb0d6c05d52f16",
                    "outputSha256": "294ba7cd239f7eba59845ab765a99c804049f5f7c1e97af230ca8a65b97e8568",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/openapi-response-check": {
      "post": {
        "operationId": "mpp_openapi_response_check",
        "summary": "OpenAPI Response Contract Check",
        "description": "Check one supplied OpenAPI 3.1 inline response against status, explicit JSON media type, parsed JSON body and deserialized headers. Exact status precedes class and default; unsupported references and schemas are explicit. Not full OpenAPI validation, wire decoding, authentication or request execution.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/openapi-response-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate supplied API response body and response headers against OpenAPI",
            "Select exact status, response class or default before checking JSON output"
          ],
          "whenToUse": [
            "Validate supplied API response body and response headers against OpenAPI",
            "Select exact status, response class or default before checking JSON output"
          ],
          "whenNotToUse": [
            "Full OpenAPI conformance, reference resolution, parameter serialization, wire parsing or live API tests",
            "Proving absence of body is an error solely because content is documented"
          ],
          "capabilities": [
            "Exact status > class > default; exact media type > type wildcard > global wildcard",
            "Reuses the bounded safe-json-schema-subset-v1 evaluator",
            "Source: https://spec.openapis.org/oas/v3.1.1.html#responses-object"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "declaredHeaders": 40,
            "schemaEvaluationsPerValue": 50000
          },
          "related": [
            "openapi-request-check",
            "openapi-lint",
            "json-schema-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1mpp~1openapi-response-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "path": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1024
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "get",
                      "put",
                      "post",
                      "delete",
                      "options",
                      "head",
                      "patch",
                      "trace"
                    ]
                  },
                  "statusCode": {
                    "type": "integer",
                    "minimum": 100,
                    "maximum": 599
                  },
                  "mediaType": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "headers": {
                    "default": {},
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "$ref": "#/paths/~1v1~1mpp~1openapi-response-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                    }
                  },
                  "body": {
                    "$ref": "#/paths/~1v1~1mpp~1openapi-response-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "document",
                  "path",
                  "method",
                  "statusCode"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-response-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1openapi-response-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "openapi": "3.1.1",
                  "info": {
                    "title": "Orders",
                    "version": "1"
                  },
                  "paths": {
                    "/orders/{id}": {
                      "get": {
                        "responses": {
                          "200": {
                            "description": "Order",
                            "headers": {
                              "X-Revision": {
                                "required": true,
                                "schema": {
                                  "type": "integer",
                                  "minimum": 1
                                }
                              }
                            },
                            "content": {
                              "application/json": {
                                "schema": {
                                  "type": "object",
                                  "required": [
                                    "id"
                                  ],
                                  "properties": {
                                    "id": {
                                      "type": "integer"
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "path": "/orders/{id}",
                "method": "get",
                "statusCode": 200,
                "mediaType": "application/json",
                "headers": {
                  "x-revision": 3
                },
                "body": {
                  "id": 7
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "openapi-response-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "openapi-inline-response-subset-v1"
                        },
                        "selectedResponse": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "selectedMediaType": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "checkedValues": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "supported": {
                          "type": "boolean"
                        },
                        "valid": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "findings": {
                          "maxItems": 150,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "selectedResponse",
                        "selectedMediaType",
                        "checkedValues",
                        "supported",
                        "valid",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "openapi-response-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "openapi-inline-response-subset-v1",
                    "selectedResponse": "200",
                    "selectedMediaType": "application/json",
                    "checkedValues": 2,
                    "supported": true,
                    "valid": true,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "371d889a55821f9bd2ab80f9f054e30a24df0c59ea8f13ef34a0a93f1b8f2561",
                    "outputSha256": "9e42eb8a67ea73a62a168a3bf735cafd6a7e6bbe981a239f6de157dff936290b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/mcp-result-check": {
      "post": {
        "operationId": "mpp_mcp_result_check",
        "summary": "MCP Tool Result Check",
        "description": "Inspect a supplied MCP CallToolResult text/structured-content envelope and optional object-root output schema. Separates tool execution errors, missing structured output, invalid text blocks and unsupported content/schema features. Does not invoke tools or prove MCP interoperability, provenance, or trust.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/mcp-result-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate MCP tool result structuredContent against outputSchema",
            "Distinguish tool execution error from malformed tool result envelope"
          ],
          "whenToUse": [
            "Validate MCP tool result structuredContent against outputSchema",
            "Distinguish tool execution error from malformed tool result envelope"
          ],
          "whenNotToUse": [
            "MCP lifecycle, JSON-RPC correlation, binary/media/resources, annotation validation or security verdicts",
            "Full JSON Schema or trusting tool output because its shape passes"
          ],
          "capabilities": [
            "Text and structured-content subset with explicit unsupported coverage",
            "Source: https://modelcontextprotocol.io/specification/2025-11-25/server/tools"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "contentBlocks": 200,
            "schemaEvaluations": 50000
          },
          "related": [
            "mcp-tool-lint",
            "jsonrpc-exchange-check",
            "json-schema-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "result": {
                    "$ref": "#/paths/~1v1~1mpp~1mcp-result-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "outputSchema": {
                    "$ref": "#/paths/~1v1~1mpp~1mcp-result-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "result"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1mcp-result-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1mcp-result-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "result": {
                  "content": [
                    {
                      "type": "text",
                      "text": "{\"count\":2}"
                    }
                  ],
                  "structuredContent": {
                    "count": 2
                  }
                },
                "outputSchema": {
                  "type": "object",
                  "required": [
                    "count"
                  ],
                  "properties": {
                    "count": {
                      "type": "integer",
                      "minimum": 0
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "mcp-result-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "mcp-text-structured-result-v1"
                        },
                        "isToolError": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "textBlocks": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "structuredContentPresent": {
                          "type": "boolean"
                        },
                        "outputSchemaChecked": {
                          "type": "boolean"
                        },
                        "supported": {
                          "type": "boolean"
                        },
                        "valid": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "findings": {
                          "maxItems": 150,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "isToolError",
                        "textBlocks",
                        "structuredContentPresent",
                        "outputSchemaChecked",
                        "supported",
                        "valid",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "mcp-result-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "mcp-text-structured-result-v1",
                    "isToolError": false,
                    "textBlocks": 1,
                    "structuredContentPresent": true,
                    "outputSchemaChecked": true,
                    "supported": true,
                    "valid": true,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "f15ab813dd2b040e164ae7fdbcc3969124d96c0cb262273ac1c3bd3e1424f75a",
                    "outputSha256": "a80d21f8ca776ae430678e746fc3900a820f242f8986c2f408d543b08f9e74eb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/sse-stream-parse": {
      "post": {
        "operationId": "mpp_sse_stream_parse",
        "summary": "SSE Snapshot Event Parser",
        "description": "Parse a completed, already-decoded server-sent-event text snapshot into dispatched events, committed last-event ID, exact decimal retry milliseconds and ignored-field count. Handles CR/LF/CRLF, one leading BOM, blank dispatch and incomplete EOF discard. No live connection, resumption or provider-specific event semantics.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/sse-stream-parse.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Parse saved SSE event stream and inspect last event ID",
            "Diagnose missing events caused by incomplete final blank line"
          ],
          "whenToUse": [
            "Parse saved SSE event stream and inspect last event ID",
            "Diagnose missing events caused by incomplete final blank line"
          ],
          "whenNotToUse": [
            "Opening an SSE stream, joining arbitrary incremental chunks or retrying connections",
            "Raw-byte UTF-8 decoding, provider completion markers or JSON-RPC protocol validation"
          ],
          "capabilities": [
            "Committed ID is distinct from an EOF-only pending ID buffer",
            "Retry decimal string avoids unsafe integer rounding",
            "Source: https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "lines": 5000,
            "events": 500,
            "eventJsonBytes": 300000
          },
          "related": [
            "jsonrpc-exchange-check",
            "ndjson-inspect",
            "retry-schedule-plan"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "initialLastEventId": {
                    "default": "",
                    "type": "string",
                    "maxLength": 4096
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "id: 42\nevent: message\ndata: {\"delta\":\"hello\"}\n\nretry: 1500\n\ndata: unfinished"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "sse-stream-parse",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "sse-completed-text-snapshot-v1"
                        },
                        "events": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "event": {
                                "type": "string"
                              },
                              "data": {
                                "type": "string"
                              },
                              "lastEventId": {
                                "type": "string"
                              },
                              "dispatchLine": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "event",
                              "data",
                              "lastEventId",
                              "dispatchLine"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "lastEventId": {
                          "type": "string"
                        },
                        "retryMilliseconds": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "ignoredFields": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "discardedPendingData": {
                          "type": "boolean"
                        },
                        "processedLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "profile",
                        "events",
                        "lastEventId",
                        "retryMilliseconds",
                        "ignoredFields",
                        "discardedPendingData",
                        "processedLines"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "sse-stream-parse",
                  "version": "0.29.0",
                  "result": {
                    "profile": "sse-completed-text-snapshot-v1",
                    "events": [
                      {
                        "event": "message",
                        "data": "{\"delta\":\"hello\"}",
                        "lastEventId": "42",
                        "dispatchLine": 4
                      }
                    ],
                    "lastEventId": "42",
                    "retryMilliseconds": "1500",
                    "ignoredFields": 0,
                    "discardedPendingData": true,
                    "processedLines": 7
                  },
                  "provenance": {
                    "inputSha256": "58b368c800a1a315f171c3001987b017f2af3ded5cf8e3247f821a75460e3edb",
                    "outputSha256": "06104a669752ff07a7d9b7d29e3d2b3a46d918fa3e5d2075bafcfb7ef0d5550a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/ndjson-inspect": {
      "post": {
        "operationId": "mpp_ndjson_inspect",
        "summary": "NDJSON Artifact Inspector",
        "description": "Inspect supplied newline-delimited JSON text into parsed records with line numbers and exact UTF-16 spans, bounded per-line diagnostics, explicit empty-line policy and optional final-newline requirement. Rejects bare CR, unsafe keys, nonfinite numbers and excessive structure; no lossless number or duplicate-key preservation.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/ndjson-inspect.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate JSON Lines or NDJSON batch artifacts with exact failing line numbers",
            "Parse newline JSON tool logs while keeping source offsets and malformed-line diagnostics"
          ],
          "whenToUse": [
            "Validate JSON Lines or NDJSON batch artifacts with exact failing line numbers",
            "Parse newline JSON tool logs while keeping source offsets and malformed-line diagnostics"
          ],
          "whenNotToUse": [
            "Streaming network ingestion, arbitrary log formats or multiline JSON documents",
            "Lossless large numbers, duplicate-key detection or implicit repair"
          ],
          "capabilities": [
            "LF and CRLF framing; strict NDJSON final newline enabled by default",
            "Source: https://github.com/ndjson/ndjson-spec"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "lines": 500,
            "aggregateParsedNodes": 12000
          },
          "related": [
            "json-schema-check",
            "record-profile",
            "sse-stream-parse"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "emptyLines": {
                    "default": "error",
                    "type": "string",
                    "enum": [
                      "ignore",
                      "error"
                    ]
                  },
                  "requireFinalNewline": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "{\"id\":\"a\",\"ok\":true}\r\n{\"id\":\"b\",\"ok\":false}\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "ndjson-inspect",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "ndjson-bounded-artifact-v1"
                        },
                        "valid": {
                          "type": "boolean"
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "UTF-16-code-units"
                        },
                        "records": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "line": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "value": {
                                "$ref": "#/paths/~1v1~1mpp~1ndjson-inspect/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            "required": [
                              "line",
                              "start",
                              "end",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "errors": {
                          "maxItems": 501,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "line": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "code": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "line",
                              "start",
                              "end",
                              "code"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "ignoredEmptyLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "finalNewline": {
                          "type": "boolean"
                        },
                        "numericPrecision": {
                          "type": "string",
                          "const": "IEEE-754; duplicate JSON object names use last value"
                        }
                      },
                      "required": [
                        "profile",
                        "valid",
                        "offsetUnit",
                        "records",
                        "errors",
                        "ignoredEmptyLines",
                        "finalNewline",
                        "numericPrecision"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1ndjson-inspect/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1ndjson-inspect/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "ndjson-inspect",
                  "version": "0.29.0",
                  "result": {
                    "profile": "ndjson-bounded-artifact-v1",
                    "valid": true,
                    "offsetUnit": "UTF-16-code-units",
                    "records": [
                      {
                        "line": 1,
                        "start": 0,
                        "end": 20,
                        "value": {
                          "id": "a",
                          "ok": true
                        }
                      },
                      {
                        "line": 2,
                        "start": 22,
                        "end": 43,
                        "value": {
                          "id": "b",
                          "ok": false
                        }
                      }
                    ],
                    "errors": [],
                    "ignoredEmptyLines": 0,
                    "finalNewline": true,
                    "numericPrecision": "IEEE-754; duplicate JSON object names use last value"
                  },
                  "provenance": {
                    "inputSha256": "d62d6909f6d24a5a208b7a2070773bdcc5fc3e42f895096bf9bd4714c905e79d",
                    "outputSha256": "9f2dc04e2f49dd9b31cfcc390eeaf23c85d4c70ea020fe20510e1ee4cd6e7506",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/uri-template-expand": {
      "post": {
        "operationId": "mpp_uri_template_expand",
        "summary": "Scalar URI Template Expansion",
        "description": "Expand RFC6570 scalar string variables with simple, reserved, fragment, label, path, path-parameter and query operators. Explicitly rejects prefix/explode modifiers, lists/maps and non-ASCII variable names/literals. Missing/null variables are omitted with an audit list; no URL fetch, safety verdict or encoding guesswork.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/uri-template-expand.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Expand scalar RFC6570 API URL templates without accidental slash or query injection",
            "Construct path and query expressions with explicit reserved expansion"
          ],
          "whenToUse": [
            "Expand scalar RFC6570 API URL templates without accidental slash or query injection",
            "Construct path and query expressions with explicit reserved expansion"
          ],
          "whenNotToUse": [
            "Full RFC6570 level 4, prefix/explode/list/map expansions or arbitrary Unicode template literals",
            "URL authorization, host allowlisting, SSRF safety or fetching"
          ],
          "capabilities": [
            "All eight operators for scalar strings; explicit null/undefined omission",
            "Source: https://www.rfc-editor.org/rfc/rfc6570.html"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "variables": 100,
            "expressions": 100,
            "templateCharacters": 10000,
            "expandedCharacters": 200000
          },
          "related": [
            "url-inspect",
            "querystring-convert",
            "openapi-request-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "template": {
                    "type": "string",
                    "maxLength": 10000
                  },
                  "variables": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 10000
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "template",
                  "variables"
                ],
                "additionalProperties": false
              },
              "example": {
                "template": "https://api.example/items/{id}{?query,cursor}",
                "variables": {
                  "id": "folder/item",
                  "query": "red blue",
                  "cursor": null
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "uri-template-expand",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "rfc6570-scalar-no-modifiers-v1"
                        },
                        "expanded": {
                          "type": "string"
                        },
                        "usedVariables": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "omittedVariables": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "unusedVariables": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "expanded",
                        "usedVariables",
                        "omittedVariables",
                        "unusedVariables"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "uri-template-expand",
                  "version": "0.29.0",
                  "result": {
                    "profile": "rfc6570-scalar-no-modifiers-v1",
                    "expanded": "https://api.example/items/folder%2Fitem?query=red%20blue",
                    "usedVariables": [
                      "id",
                      "query",
                      "cursor"
                    ],
                    "omittedVariables": [
                      "cursor"
                    ],
                    "unusedVariables": []
                  },
                  "provenance": {
                    "inputSha256": "e1935af27af4ababb587b1266ec5524c79d346c9ddb94bc2e6b72cd351c0942b",
                    "outputSha256": "6740b12989926a33df7c5ef4d44a32b7360051d4b52553a4c63bbaac6adcb5f9",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/cloudevents-envelope-check": {
      "post": {
        "operationId": "mpp_cloudevents_envelope_check",
        "summary": "CloudEvents JSON Envelope Check",
        "description": "Inspect one structured CloudEvents 1.0 JSON artifact for required attributes, string restrictions, time/calendar profile, data/data_base64 conflicts, canonical Base64 and primary extension mappings. URI checks are ASCII lexical only. No webhook signatures, transport binding, extension semantics or event authenticity checks.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/cloudevents-envelope-check.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate a supplied CloudEvents structured webhook envelope before ingestion",
            "Detect conflicting CloudEvents payload modes and invalid extension attributes"
          ],
          "whenToUse": [
            "Validate a supplied CloudEvents structured webhook envelope before ingestion",
            "Detect conflicting CloudEvents payload modes and invalid extension attributes"
          ],
          "whenNotToUse": [
            "Authenticating webhook senders, binary HTTP bindings, schema fetching or complete URI conformance",
            "Leap-second validation or secondary structured extension mappings"
          ],
          "capabilities": [
            "Null attributes mean unset; explicit null data remains data",
            "Source: https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/formats/json-format.md"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "events": 1,
            "extensionIntegerMinimum": -2147483648,
            "extensionIntegerMaximum": 2147483647
          },
          "related": [
            "json-schema-check",
            "content-digest",
            "jsonrpc-exchange-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "event": {
                    "$ref": "#/paths/~1v1~1mpp~1cloudevents-envelope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "event"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1cloudevents-envelope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1cloudevents-envelope-check/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "event": {
                  "specversion": "1.0",
                  "id": "evt-7",
                  "source": "/agent/orders",
                  "type": "com.example.order.updated",
                  "time": "2026-10-04T12:00:00Z",
                  "datacontenttype": "application/json",
                  "data": {
                    "orderId": "o-2"
                  },
                  "attempt": 1
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "cloudevents-envelope-check",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "cloudevents-json-envelope-subset-v1"
                        },
                        "identity": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "source": {
                                  "type": "string"
                                },
                                "id": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "source",
                                "id"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "dataMode": {
                          "type": "string",
                          "enum": [
                            "absent",
                            "json",
                            "encoded-string",
                            "base64",
                            "conflict",
                            "unknown"
                          ]
                        },
                        "decodedBytes": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "extensionNames": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "supported": {
                          "type": "boolean"
                        },
                        "valid": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "findings": {
                          "maxItems": 150,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "identity",
                        "dataMode",
                        "decodedBytes",
                        "extensionNames",
                        "supported",
                        "valid",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "cloudevents-envelope-check",
                  "version": "0.29.0",
                  "result": {
                    "profile": "cloudevents-json-envelope-subset-v1",
                    "identity": {
                      "source": "/agent/orders",
                      "id": "evt-7"
                    },
                    "dataMode": "json",
                    "decodedBytes": null,
                    "extensionNames": [
                      "attempt"
                    ],
                    "supported": true,
                    "valid": true,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "75566fa290118562edced06b8b2e56383a5815e3567820e673dc69d0bb685abe",
                    "outputSha256": "ab59d76abba7550e73885e13376c82742a6ccac76b210e0c94543bc430baa1b7",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/http-link-parse": {
      "post": {
        "operationId": "mpp_http_link_parse",
        "summary": "HTTP Link Header Parser",
        "description": "Parse supplied HTTP Link field values with quote-aware commas, escaped quoted parameters, relations and anchor context. Preserves raw URI references/parameters and first-rel semantics; flags unsupported extended parameters. Does not resolve/fetch links, apply anchors, inspect live pagination or certify full RFC8288 conformance.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-link-parse.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Extract pagination next and last relations from supplied HTTP Link headers",
            "Parse quoted comma parameters and detect anchor-dependent links"
          ],
          "whenToUse": [
            "Extract pagination next and last relations from supplied HTTP Link headers",
            "Parse quoted comma parameters and detect anchor-dependent links"
          ],
          "whenNotToUse": [
            "Following pagination links, URL resolution, link safety or decoding extended title parameters",
            "Treating an anchored link as if it belonged to the original response context"
          ],
          "capabilities": [
            "Raw target and anchor preserved with usableWithoutAnchor flag",
            "Source: https://www.rfc-editor.org/rfc/rfc8288.html"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "headerFields": 20,
            "fieldCharacters": 16000,
            "links": 200,
            "parametersPerLink": 50
          },
          "related": [
            "http-headers-normalize",
            "url-inspect",
            "openapi-response-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "headerValues": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 16000
                    }
                  }
                },
                "required": [
                  "headerValues"
                ],
                "additionalProperties": false
              },
              "example": {
                "headerValues": [
                  "</items?page=2>; rel=\"next\"; title=\"More, items\", </items?page=5>; rel=\"last\""
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-link-parse",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-link-framing-subset-v1"
                        },
                        "links": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "target": {
                                "type": "string"
                              },
                              "relations": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "anchor": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "usableWithoutAnchor": {
                                "type": "boolean"
                              },
                              "parameters": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string"
                                    },
                                    "value": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "target",
                              "relations",
                              "anchor",
                              "usableWithoutAnchor",
                              "parameters"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "supported": {
                          "type": "boolean"
                        },
                        "valid": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "findings": {
                          "maxItems": 150,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "error",
                                  "warning",
                                  "unsupported"
                                ]
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "severity",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "links",
                        "supported",
                        "valid",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-link-parse",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-link-framing-subset-v1",
                    "links": [
                      {
                        "target": "/items?page=2",
                        "relations": [
                          "next"
                        ],
                        "anchor": null,
                        "usableWithoutAnchor": true,
                        "parameters": [
                          {
                            "name": "rel",
                            "value": "next"
                          },
                          {
                            "name": "title",
                            "value": "More, items"
                          }
                        ]
                      },
                      {
                        "target": "/items?page=5",
                        "relations": [
                          "last"
                        ],
                        "anchor": null,
                        "usableWithoutAnchor": true,
                        "parameters": [
                          {
                            "name": "rel",
                            "value": "last"
                          }
                        ]
                      }
                    ],
                    "supported": true,
                    "valid": true,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "936f87f1083a7b82908769f15bbc84a30bcf31f5740b62694bb1b5048d718db6",
                    "outputSha256": "fb895fa83b3582836a18817d4a453dd54e0907b079388c204ad7d5fe27ed7b17",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/http-etag-evaluate": {
      "post": {
        "operationId": "mpp_http_etag_evaluate",
        "summary": "HTTP Entity-Tag Preconditions",
        "description": "Evaluate supplied If-Match and If-None-Match against caller-asserted representation existence/current ETag, preserving strong/weak comparison and precondition order. Gives conditional 304/412 or proceed guidance only. Excludes date/range/freshness, duplicate-write exceptions, permission decisions and live requests.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-etag-evaluate.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Evaluate conditional HTTP ETag cache validation and optimistic concurrency preconditions",
            "Distinguish weak If-None-Match from strong If-Match and wildcard existence"
          ],
          "whenToUse": [
            "Evaluate conditional HTTP ETag cache validation and optimistic concurrency preconditions",
            "Distinguish weak If-None-Match from strong If-Match and wildcard existence"
          ],
          "whenNotToUse": [
            "Cache freshness, date validators, HTTP ranges, fetching resources or deciding replay authorization",
            "Guaranteed success status or inferring current representation from an ETag alone"
          ],
          "capabilities": [
            "Method tokens are case-sensitive; only uppercase GET/HEAD yield 304",
            "Source: https://www.rfc-editor.org/rfc/rfc9110.html#name-preconditions"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 150,
            "findingJsonBytes": 300000,
            "tagsPerField": 200,
            "fieldCharacters": 16000
          },
          "related": [
            "http-headers-normalize",
            "retry-schedule-plan",
            "openapi-request-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_TEMPLATE",
            "UNSUPPORTED_TEMPLATE",
            "INVALID_HEADER",
            "INVALID_ETAG",
            "INVALID_REPRESENTATION",
            "OPERATION_NOT_FOUND",
            "LINE_LIMIT",
            "EVENT_LIMIT",
            "LINK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "method": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 32
                  },
                  "representationExists": {
                    "type": "boolean"
                  },
                  "currentEtag": {
                    "type": "string",
                    "maxLength": 4096
                  },
                  "ifMatch": {
                    "type": "string",
                    "maxLength": 16000
                  },
                  "ifNoneMatch": {
                    "type": "string",
                    "maxLength": 16000
                  }
                },
                "required": [
                  "method",
                  "representationExists"
                ],
                "additionalProperties": false
              },
              "example": {
                "method": "GET",
                "representationExists": true,
                "currentEtag": "\"revision-7\"",
                "ifNoneMatch": "W/\"revision-7\""
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-etag-evaluate",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-entity-tag-preconditions-v1"
                        },
                        "decision": {
                          "type": "string",
                          "enum": [
                            "proceed",
                            "not-modified",
                            "precondition-failed"
                          ]
                        },
                        "suggestedStatus": {
                          "anyOf": [
                            {
                              "type": "number",
                              "const": 304
                            },
                            {
                              "type": "number",
                              "const": 412
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "evaluated": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "field": {
                                "type": "string",
                                "enum": [
                                  "if-match",
                                  "if-none-match"
                                ]
                              },
                              "comparison": {
                                "type": "string",
                                "enum": [
                                  "strong",
                                  "weak"
                                ]
                              },
                              "passes": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "field",
                              "comparison",
                              "passes"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "assumptions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "decision",
                        "suggestedStatus",
                        "evaluated",
                        "assumptions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-etag-evaluate",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-entity-tag-preconditions-v1",
                    "decision": "not-modified",
                    "suggestedStatus": 304,
                    "evaluated": [
                      {
                        "field": "if-none-match",
                        "comparison": "weak",
                        "passes": false
                      }
                    ],
                    "assumptions": [
                      "Normal request checks already succeeded; only If-Match and If-None-Match are evaluated",
                      "Representation selection/existence and current entity-tag are caller assertions",
                      "No date/range/cache-freshness checks, duplicate-write exception, authorization, or network request",
                      "Proceed means these supplied preconditions permit continuing normal request processing, not guaranteed success"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "728b21287315350b2cb828a2620f4e94542eab7bfee981d92d0d2545b552a41d",
                    "outputSha256": "1d723e87ba064217415f2ce5bc9d80034d6a00b041f831924a89bcd55c27e04a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-structural-diff": {
      "post": {
        "operationId": "mpp_json_structural_diff",
        "summary": "JSON Structural Patch Generator",
        "description": "Generate deterministic RFC 6902 add/remove/replace operations between supplied JSON values, with recursive object comparison, atomic arrays, escaped pointers and source/target digests. Does not infer moves or produce a minimal edit script.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-structural-diff.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate JSON Patch from two document versions",
            "Find changed nested fields and produce machine-applicable operations"
          ],
          "whenToUse": [
            "Generate JSON Patch from two document versions",
            "Find changed nested fields and produce machine-applicable operations"
          ],
          "whenNotToUse": [
            "Minimal array edit scripts, move detection, or arbitrary-precision JSON numbers",
            "Applying changes to remote files or APIs"
          ],
          "capabilities": [
            "RFC 6902 add/remove/replace output with RFC 6901 pointers",
            "Arrays replaced atomically; object property order ignored",
            "SHA-256 of deterministic sorted-object serialization; not RFC 8785"
          ],
          "related": [
            "json-patch",
            "json-three-way-merge"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "patchOperations": 500,
            "pointerCodeUnits": 2048,
            "patchPayloadBytes": 380000,
            "arrayPolicy": "atomic",
            "digestProfile": "sorted-object-json-utf8-v1"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "PATCH_LIMIT",
            "POINTER_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "before": {
                    "$ref": "#/paths/~1v1~1mpp~1json-structural-diff/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "after": {
                    "$ref": "#/paths/~1v1~1mpp~1json-structural-diff/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "before",
                  "after"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-structural-diff/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-structural-diff/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "before": {
                  "title": "Draft",
                  "tags": [
                    "review"
                  ],
                  "obsolete": true
                },
                "after": {
                  "title": "Ready",
                  "tags": [
                    "review",
                    "approved"
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-structural-diff",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "object-recursive-array-atomic-diff-v1"
                        },
                        "equal": {
                          "type": "boolean"
                        },
                        "patch": {
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "op": {
                                    "type": "string",
                                    "enum": [
                                      "add",
                                      "replace"
                                    ]
                                  },
                                  "path": {
                                    "type": "string"
                                  },
                                  "value": {
                                    "$ref": "#/paths/~1v1~1mpp~1json-structural-diff/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "required": [
                                  "op",
                                  "path",
                                  "value"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "op": {
                                    "type": "string",
                                    "const": "remove"
                                  },
                                  "path": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "op",
                                  "path"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        },
                        "operationCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "sourceSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "targetSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "digestEncoding": {
                          "type": "string",
                          "const": "sorted-object-json-utf8-v1"
                        }
                      },
                      "required": [
                        "profile",
                        "equal",
                        "patch",
                        "operationCount",
                        "sourceSha256",
                        "targetSha256",
                        "digestEncoding"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-structural-diff/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-structural-diff/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-structural-diff",
                  "version": "0.29.0",
                  "result": {
                    "profile": "object-recursive-array-atomic-diff-v1",
                    "equal": false,
                    "patch": [
                      {
                        "op": "remove",
                        "path": "/obsolete"
                      },
                      {
                        "op": "replace",
                        "path": "/tags",
                        "value": [
                          "review",
                          "approved"
                        ]
                      },
                      {
                        "op": "replace",
                        "path": "/title",
                        "value": "Ready"
                      }
                    ],
                    "operationCount": 3,
                    "sourceSha256": "0a34630d562483cee11e48ba6adaeeecceaf6017794835b64d48fd7d81595735",
                    "targetSha256": "d5d727ab6f9598418bfa4c3bfbb83f294f791a046f9a3455baba3cd580c12fa3",
                    "digestEncoding": "sorted-object-json-utf8-v1"
                  },
                  "provenance": {
                    "inputSha256": "1bcf3fa1e1786afa4a3db326acc4a66d1738e5c7d742fac8c26b5393c8ae43ea",
                    "outputSha256": "f105bd87aeb5589d1c84771c0f279373ded003e50d3fd532672e65b7756edc86",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-three-way-merge": {
      "post": {
        "operationId": "mpp_json_three_way_merge",
        "summary": "JSON Three-Way Merge",
        "description": "Merge two supplied JSON document branches against an explicit base. Recursively merges object members, treats arrays atomically, distinguishes deletion from null, and returns no merged document when any conflict exists. Does not resolve semantic or textual conflicts.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-three-way-merge.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Merge independent JSON document edits against a common base",
            "Detect delete-versus-modify conflicts before combining agent results"
          ],
          "whenToUse": [
            "Merge independent JSON document edits against a common base",
            "Detect delete-versus-modify conflicts before combining agent results"
          ],
          "whenNotToUse": [
            "CRDT synchronization, line-based text merging or semantic conflict resolution",
            "Element-wise merging of arrays or applying partial conflict results"
          ],
          "capabilities": [
            "Presence-aware conflict snapshots and escaped JSON Pointer paths",
            "Disjoint additions to a new object can merge",
            "Any conflict makes merged and mergedSha256 null; clean distinguishes a legitimate null document"
          ],
          "related": [
            "json-structural-diff",
            "json-patch"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "conflicts": 200,
            "pointerCodeUnits": 2048,
            "conflictPayloadBytes": 380000,
            "arrayPolicy": "atomic",
            "conflictPolicy": "no-partial-result"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "CONFLICT_LIMIT",
            "POINTER_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "base": {
                    "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "ours": {
                    "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "theirs": {
                    "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "base",
                  "ours",
                  "theirs"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "base": {
                  "title": "Draft",
                  "review": {
                    "owner": "Ada",
                    "status": "open"
                  }
                },
                "ours": {
                  "title": "Ready",
                  "review": {
                    "owner": "Ada",
                    "status": "open"
                  }
                },
                "theirs": {
                  "title": "Draft",
                  "review": {
                    "owner": "Ada",
                    "status": "approved"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-three-way-merge",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "three-way-object-merge-v1"
                        },
                        "clean": {
                          "type": "boolean"
                        },
                        "merged": {
                          "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        },
                        "conflicts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "delete-modify",
                                  "concurrent-change"
                                ]
                              },
                              "base": {
                                "type": "object",
                                "properties": {
                                  "exists": {
                                    "type": "boolean"
                                  },
                                  "value": {
                                    "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "required": [
                                  "exists",
                                  "value"
                                ],
                                "additionalProperties": false
                              },
                              "ours": {
                                "type": "object",
                                "properties": {
                                  "exists": {
                                    "type": "boolean"
                                  },
                                  "value": {
                                    "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "required": [
                                  "exists",
                                  "value"
                                ],
                                "additionalProperties": false
                              },
                              "theirs": {
                                "type": "object",
                                "properties": {
                                  "exists": {
                                    "type": "boolean"
                                  },
                                  "value": {
                                    "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "required": [
                                  "exists",
                                  "value"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "path",
                              "kind",
                              "base",
                              "ours",
                              "theirs"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "conflictCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "baseSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "oursSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "theirsSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "mergedSha256": {
                          "anyOf": [
                            {
                              "type": "string",
                              "pattern": "^[a-fA-F0-9]{64}$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "digestEncoding": {
                          "type": "string",
                          "const": "sorted-object-json-utf8-v1"
                        }
                      },
                      "required": [
                        "profile",
                        "clean",
                        "merged",
                        "conflicts",
                        "conflictCount",
                        "baseSha256",
                        "oursSha256",
                        "theirsSha256",
                        "mergedSha256",
                        "digestEncoding"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-three-way-merge/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-three-way-merge",
                  "version": "0.29.0",
                  "result": {
                    "profile": "three-way-object-merge-v1",
                    "clean": true,
                    "merged": {
                      "review": {
                        "owner": "Ada",
                        "status": "approved"
                      },
                      "title": "Ready"
                    },
                    "conflicts": [],
                    "conflictCount": 0,
                    "baseSha256": "4637b695975b02a56c1a9f66ecdd3a736757230debeab5ab8a31ab223dafdeab",
                    "oursSha256": "b1aef96452b997b6b18b042fe24d61b1c0d875e6b8eb02fdcbf90911d48a7306",
                    "theirsSha256": "457e27eeb47fa5a0d1edbb5b1853c5b39ae5c6258275c798c02dfdff3cfc3316",
                    "mergedSha256": "2253f6a38d03688187fbe28688fe40cef7e5fa6a0145241fb257ed8ca972595c",
                    "digestEncoding": "sorted-object-json-utf8-v1"
                  },
                  "provenance": {
                    "inputSha256": "ffc6b6c4229c5d19d1277e4be55dd04320b79b74e3ac625399997ade181953ea",
                    "outputSha256": "6078f9e0ab50af924e599ce85b6c13d2e042ac6795ec40c2b720b0a1ab63e3b5",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/text-edits-apply": {
      "post": {
        "operationId": "mpp_text_edits_apply",
        "summary": "Checked Text Edit Application",
        "description": "Atomically apply explicit nonoverlapping UTF-16 text edits after exact expected-slice and optional SHA-256 checks. Returns edited text, applied IDs and unchanged/replacement source mappings. Rejects split Unicode scalars and ambiguous insertion boundaries.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-edits-apply.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Apply agent-proposed document edits with exact source assertions",
            "Produce source-to-result offset evidence for controlled text transformations"
          ],
          "whenToUse": [
            "Apply agent-proposed document edits with exact source assertions",
            "Produce source-to-result offset evidence for controlled text transformations"
          ],
          "whenNotToUse": [
            "Fuzzy matching, natural-language revision or edits to files on disk",
            "Mapping semantic annotations inside replacement text"
          ],
          "capabilities": [
            "Atomic original-source coordinates and expected text on every edit",
            "SHA-256 source/result provenance and explicit mapping segments",
            "No Unicode normalization or newline rewriting"
          ],
          "related": [
            "text-offset-map",
            "document-chunk-audit"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "edits": 200,
            "resultCodeUnits": 200000,
            "offsetUnit": "utf16-code-units"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "DUPLICATE_ID",
            "INVALID_SPAN",
            "INVALID_BOUNDARY",
            "OVERLAPPING_EDITS",
            "EDIT_EXPECTATION_MISMATCH",
            "SOURCE_DIGEST_MISMATCH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "expectedSha256": {
                    "type": "string",
                    "pattern": "^[a-fA-F0-9]{64}$"
                  },
                  "edits": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "expected": {
                          "type": "string",
                          "maxLength": 90000
                        },
                        "replacement": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "id",
                        "start",
                        "end",
                        "expected",
                        "replacement"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "text",
                  "edits"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Status: draft. Owner: Ada.",
                "edits": [
                  {
                    "id": "approve",
                    "start": 8,
                    "end": 13,
                    "expected": "draft",
                    "replacement": "approved"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-edits-apply",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "checked-utf16-edits-v1"
                        },
                        "text": {
                          "type": "string"
                        },
                        "sourceSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "resultSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "appliedEditIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "mapping": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "unchanged",
                                  "replacement"
                                ]
                              },
                              "editId": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "sourceStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "sourceEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "resultStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "resultEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "kind",
                              "editId",
                              "sourceStart",
                              "sourceEnd",
                              "resultStart",
                              "resultEnd"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "text",
                        "sourceSha256",
                        "resultSha256",
                        "appliedEditIds",
                        "mapping"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-edits-apply",
                  "version": "0.29.0",
                  "result": {
                    "profile": "checked-utf16-edits-v1",
                    "text": "Status: approved. Owner: Ada.",
                    "sourceSha256": "337061ebf7debcb2aa7c3c8d377a51252766fe4d8463db95a1e92bde917801b4",
                    "resultSha256": "9a035e2245d18debca13e5035077c0b4f99b15ffbe096a931aa2869948adfbde",
                    "appliedEditIds": [
                      "approve"
                    ],
                    "mapping": [
                      {
                        "kind": "unchanged",
                        "editId": null,
                        "sourceStart": 0,
                        "sourceEnd": 8,
                        "resultStart": 0,
                        "resultEnd": 8
                      },
                      {
                        "kind": "replacement",
                        "editId": "approve",
                        "sourceStart": 8,
                        "sourceEnd": 13,
                        "resultStart": 8,
                        "resultEnd": 16
                      },
                      {
                        "kind": "unchanged",
                        "editId": null,
                        "sourceStart": 13,
                        "sourceEnd": 26,
                        "resultStart": 16,
                        "resultEnd": 29
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "ea5b685091d59b005a2dbb8d8c00538af94be5694555cae5bbef485e8d72fe7f",
                    "outputSha256": "da1702f71331c0a23e70c9f870d9a63e2e3bf4891b0eb3fd6693a1135f1822a5",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/text-offset-map": {
      "post": {
        "operationId": "mpp_text_offset_map",
        "summary": "Unicode Evidence Offset Mapping",
        "description": "Translate caller-supplied UTF-8 byte, UTF-16 code-unit or Unicode code-point offsets into all three coordinate systems and LF-based line/column positions. Only exact scalar boundaries are valid; text is never normalized or rewritten.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-offset-map.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Reconcile byte and character offsets from different extraction tools",
            "Convert annotation spans between UTF-8 UTF-16 and code-point systems"
          ],
          "whenToUse": [
            "Reconcile byte and character offsets from different extraction tools",
            "Convert annotation spans between UTF-8 UTF-16 and code-point systems"
          ],
          "whenNotToUse": [
            "Grapheme cluster, display-width, tokenizer or normalization mapping",
            "Offsets into binary files or malformed Unicode"
          ],
          "capabilities": [
            "Rejects offsets inside multibyte UTF-8 sequences or surrogate pairs",
            "Line and column are 1-based; LF starts a new line and CR counts as a scalar",
            "Duplicate offsets preserve caller order"
          ],
          "related": [
            "evidence-quote-check",
            "text-edits-apply"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "offsets": 1000,
            "textCodeUnits": 90000,
            "lineConvention": "1-based-LF-lines-codepoint-columns"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "OFFSET_OUT_OF_RANGE",
            "INVALID_BOUNDARY"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "from": {
                    "type": "string",
                    "enum": [
                      "utf16",
                      "utf8",
                      "codepoint"
                    ]
                  },
                  "offsets": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 360000
                    }
                  }
                },
                "required": [
                  "text",
                  "from",
                  "offsets"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "A😀\né",
                "from": "utf8",
                "offsets": [
                  0,
                  1,
                  5,
                  6,
                  8
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-offset-map",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "unicode-scalar-offset-map-v1"
                        },
                        "points": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "input": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "utf16": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "utf8": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "codepoint": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "line": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "column": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "input",
                              "utf16",
                              "utf8",
                              "codepoint",
                              "line",
                              "column"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "totals": {
                          "type": "object",
                          "properties": {
                            "utf16": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "utf8": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "codepoint": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "lines": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "utf16",
                            "utf8",
                            "codepoint",
                            "lines"
                          ],
                          "additionalProperties": false
                        },
                        "lineConvention": {
                          "type": "string",
                          "const": "1-based-LF-lines-codepoint-columns"
                        }
                      },
                      "required": [
                        "profile",
                        "points",
                        "totals",
                        "lineConvention"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-offset-map",
                  "version": "0.29.0",
                  "result": {
                    "profile": "unicode-scalar-offset-map-v1",
                    "points": [
                      {
                        "input": 0,
                        "utf16": 0,
                        "utf8": 0,
                        "codepoint": 0,
                        "line": 1,
                        "column": 1
                      },
                      {
                        "input": 1,
                        "utf16": 1,
                        "utf8": 1,
                        "codepoint": 1,
                        "line": 1,
                        "column": 2
                      },
                      {
                        "input": 5,
                        "utf16": 3,
                        "utf8": 5,
                        "codepoint": 2,
                        "line": 1,
                        "column": 3
                      },
                      {
                        "input": 6,
                        "utf16": 4,
                        "utf8": 6,
                        "codepoint": 3,
                        "line": 2,
                        "column": 1
                      },
                      {
                        "input": 8,
                        "utf16": 5,
                        "utf8": 8,
                        "codepoint": 4,
                        "line": 2,
                        "column": 2
                      }
                    ],
                    "totals": {
                      "utf16": 5,
                      "utf8": 8,
                      "codepoint": 4,
                      "lines": 2
                    },
                    "lineConvention": "1-based-LF-lines-codepoint-columns"
                  },
                  "provenance": {
                    "inputSha256": "b96469ff1344750024c3ccbbc17e975ddfefb337ec5759bfd1515689289beee8",
                    "outputSha256": "1fd72d8c7258d8e48f78132366cde6e3eceece17efe526d8cf9b606f512113ee",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/unified-diff-apply": {
      "post": {
        "operationId": "mpp_unified_diff_apply",
        "summary": "Exact Unified Patch Application",
        "description": "Apply a single-file supplied unified diff to supplied LF text with exact old/new hunk positions, exact context matching, final-newline markers and optional source digest/label assertions. Labels are inert metadata. No fuzzy offsets, Git prelude, filesystem writes or external content.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/unified-diff-apply.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Validate and apply a model-generated unified patch to supplied document text",
            "Reject stale patch context before accepting a document revision"
          ],
          "whenToUse": [
            "Validate and apply a model-generated unified patch to supplied document text",
            "Reject stale patch context before accepting a document revision"
          ],
          "whenNotToUse": [
            "Multi-file patches, Git binary patches, rename metadata, fuzz or CRLF text",
            "Filesystem access, path safety validation, or applying a patch to a repository"
          ],
          "capabilities": [
            "Single ---/+++ header pair and at most 200 exact-position hunks",
            "LF-only text with GNU no-newline markers",
            "New hunk positions must match accumulated line deltas"
          ],
          "related": [
            "lines-diff",
            "text-edits-apply"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "hunks": 200,
            "sourceLines": 10000,
            "resultLines": 10000,
            "patchLines": 20000,
            "lineEndings": "LF-only"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "UNSUPPORTED_LINE_ENDING",
            "INVALID_PATCH",
            "LINE_LIMIT",
            "HUNK_LIMIT",
            "HUNK_RANGE_MISMATCH",
            "PATCH_CONTEXT_MISMATCH",
            "PATCH_LABEL_MISMATCH",
            "SOURCE_DIGEST_MISMATCH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "patch": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "expectedSha256": {
                    "type": "string",
                    "pattern": "^[a-fA-F0-9]{64}$"
                  },
                  "expectedOldLabel": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 512
                  }
                },
                "required": [
                  "text",
                  "patch"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Title\nDraft\n",
                "patch": "--- memo.txt\n+++ memo.txt\n@@ -1,2 +1,2 @@\n Title\n-Draft\n+Approved\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "unified-diff-apply",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "single-file-exact-unified-v1"
                        },
                        "text": {
                          "type": "string"
                        },
                        "oldLabel": {
                          "type": "string"
                        },
                        "newLabel": {
                          "type": "string"
                        },
                        "sourceSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "resultSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "hunks": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "oldStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "oldCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "newStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "newCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "added": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "removed": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "context": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "oldStart",
                              "oldCount",
                              "newStart",
                              "newCount",
                              "added",
                              "removed",
                              "context"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "addedLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "removedLines": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "profile",
                        "text",
                        "oldLabel",
                        "newLabel",
                        "sourceSha256",
                        "resultSha256",
                        "hunks",
                        "addedLines",
                        "removedLines"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "unified-diff-apply",
                  "version": "0.29.0",
                  "result": {
                    "profile": "single-file-exact-unified-v1",
                    "text": "Title\nApproved\n",
                    "oldLabel": "memo.txt",
                    "newLabel": "memo.txt",
                    "sourceSha256": "a9f5e927daf42ccddfd5b3d32339fc81e8a2542fa4e3034818c1e74c83d93d90",
                    "resultSha256": "784e8c6360e6639a1996ceea7e1f0c07d5a81d6b37bd100fc2143774af9b1f19",
                    "hunks": [
                      {
                        "oldStart": 1,
                        "oldCount": 2,
                        "newStart": 1,
                        "newCount": 2,
                        "added": 1,
                        "removed": 1,
                        "context": 1
                      }
                    ],
                    "addedLines": 1,
                    "removedLines": 1
                  },
                  "provenance": {
                    "inputSha256": "90c3e1079c87b9e2946db7c3a80a0106c364f3f90dab9ae89143cc4ae1d7b2fd",
                    "outputSha256": "46af28a70cd21a1ab902e6cb5af4cd38dc3def274362e3bffdfed748131c181c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/markdown-table-extract": {
      "post": {
        "operationId": "mpp_markdown_table_extract",
        "summary": "Markdown Pipe Table Extraction",
        "description": "Extract top-level pipe tables from supplied Markdown into bounded cell arrays with exact source offsets, alignment and width findings. Uses an explicit line-based subset: table starts at document start or after a blank line, three-hyphen delimiters, fences excluded, inline markup preserved.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/markdown-table-extract.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Extract structured rows and cell provenance from Markdown reports",
            "Check pipe table widths without silently dropping or padding cells"
          ],
          "whenToUse": [
            "Extract structured rows and cell provenance from Markdown reports",
            "Check pipe table widths without silently dropping or padding cells"
          ],
          "whenNotToUse": [
            "Full CommonMark or GFM parsing, nested containers, HTML tables or inline rendering",
            "Automatic schema inference, typed values or ambiguous one-hyphen delimiters"
          ],
          "capabilities": [
            "Backslash-escaped pipes and optional outer pipes",
            "Fenced code is excluded; inline backticks do not protect an unescaped pipe",
            "Raw cell slices preserved with UTF-16 offsets; malformed row widths remain visible"
          ],
          "related": [
            "csv-serialize",
            "record-constraints"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "tables": 50,
            "rowsPerTable": 500,
            "columns": 50,
            "cells": 5000,
            "lines": 10000,
            "profile": "top-level-pipe-tables-v1"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "LINE_LIMIT",
            "TABLE_LIMIT",
            "ROW_LIMIT",
            "CELL_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string",
                    "maxLength": 90000
                  }
                },
                "required": [
                  "markdown"
                ],
                "additionalProperties": false
              },
              "example": {
                "markdown": "| Item | State |\n| :--- | ---: |\n| Report | approved |\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "markdown-table-extract",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "top-level-pipe-tables-v1"
                        },
                        "tables": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "startLine": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "endLine": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "header": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "raw": {
                                      "type": "string"
                                    },
                                    "text": {
                                      "type": "string"
                                    },
                                    "start": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "end": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "raw",
                                    "text",
                                    "start",
                                    "end"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "alignment": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "enum": [
                                    "left",
                                    "center",
                                    "right",
                                    "none"
                                  ]
                                }
                              },
                              "rows": {
                                "type": "array",
                                "items": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "raw": {
                                        "type": "string"
                                      },
                                      "text": {
                                        "type": "string"
                                      },
                                      "start": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      "end": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "raw",
                                      "text",
                                      "start",
                                      "end"
                                    ],
                                    "additionalProperties": false
                                  }
                                }
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "startLine",
                              "endLine",
                              "header",
                              "alignment",
                              "rows"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "tableCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "cellCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "tables",
                        "tableCount",
                        "cellCount",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "markdown-table-extract",
                  "version": "0.29.0",
                  "result": {
                    "profile": "top-level-pipe-tables-v1",
                    "tables": [
                      {
                        "start": 0,
                        "end": 54,
                        "startLine": 1,
                        "endLine": 3,
                        "header": [
                          {
                            "raw": "Item",
                            "text": "Item",
                            "start": 2,
                            "end": 6
                          },
                          {
                            "raw": "State",
                            "text": "State",
                            "start": 9,
                            "end": 14
                          }
                        ],
                        "alignment": [
                          "left",
                          "right"
                        ],
                        "rows": [
                          [
                            {
                              "raw": "Report",
                              "text": "Report",
                              "start": 35,
                              "end": 41
                            },
                            {
                              "raw": "approved",
                              "text": "approved",
                              "start": 44,
                              "end": 52
                            }
                          ]
                        ]
                      }
                    ],
                    "tableCount": 1,
                    "cellCount": 4,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "9f9d5f26b45ac5623ed318d00210ca35ead401a4330a17032bb62cf64f226f7a",
                    "outputSha256": "001672fc563cbade4eff0027b426283e54ddd7e9e26800b5033cbab8f9a65fe8",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/document-chunk-audit": {
      "post": {
        "operationId": "mpp_document_chunk_audit",
        "summary": "Document Chunk Integrity Audit",
        "description": "Audit supplied retrieval/document chunks against their exact source spans and compute verified coverage, uncovered ranges, overlap depth and policy findings. Invalid chunks never contribute coverage. Checks identity and coverage only, not retrieval quality or semantic relevance.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/document-chunk-audit.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Verify exported RAG chunks reconstruct and cover their source document",
            "Find stale chunk text, gaps or forbidden overlaps before indexing"
          ],
          "whenToUse": [
            "Verify exported RAG chunks reconstruct and cover their source document",
            "Find stale chunk text, gaps or forbidden overlaps before indexing"
          ],
          "whenNotToUse": [
            "Semantic chunk quality, source authenticity, OCR correction or embedding validation",
            "Comparing independent ground-truth annotation datasets"
          ],
          "capabilities": [
            "Only exact nonempty scalar-aligned UTF-16 spans count toward coverage",
            "Sweep-line union, gap and overlap-depth evidence",
            "Full coverage and overlap policies supplied explicitly; defaults require full coverage and permit overlap"
          ],
          "related": [
            "text-chunk",
            "text-offset-map",
            "evidence-quote-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "chunks": 200,
            "offsetUnit": "utf16-code-units",
            "coverageUnit": "utf16-code-units"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "DUPLICATE_ID"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "chunks": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 90000
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "id",
                        "start",
                        "end",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "requireFullCoverage": {
                    "default": true,
                    "type": "boolean"
                  },
                  "allowOverlap": {
                    "default": true,
                    "type": "boolean"
                  }
                },
                "required": [
                  "text",
                  "chunks"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "alpha beta gamma",
                "chunks": [
                  {
                    "id": "a",
                    "start": 0,
                    "end": 10,
                    "text": "alpha beta"
                  },
                  {
                    "id": "b",
                    "start": 6,
                    "end": 16,
                    "text": "beta gamma"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "document-chunk-audit",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "exact-chunk-coverage-v1"
                        },
                        "passesChecks": {
                          "type": "boolean"
                        },
                        "sourceSha256": {
                          "type": "string",
                          "pattern": "^[a-fA-F0-9]{64}$"
                        },
                        "statuses": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "verified",
                                  "invalid-span",
                                  "invalid-boundary",
                                  "text-mismatch"
                                ]
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "id",
                              "status",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "coverage": {
                          "type": "object",
                          "properties": {
                            "sourceCodeUnits": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "coveredCodeUnits": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "uncoveredCodeUnits": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "overlapCodeUnits": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "maxDepth": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "sourceCodeUnits",
                            "coveredCodeUnits",
                            "uncoveredCodeUnits",
                            "overlapCodeUnits",
                            "maxDepth"
                          ],
                          "additionalProperties": false
                        },
                        "uncoveredRanges": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "overlapRanges": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "depth": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "depth"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "passesChecks",
                        "sourceSha256",
                        "statuses",
                        "coverage",
                        "uncoveredRanges",
                        "overlapRanges",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "document-chunk-audit",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-chunk-coverage-v1",
                    "passesChecks": true,
                    "sourceSha256": "64989ccbf3efa9c84e2afe7cee9bc5828bf0fcb91e44f8c1e591638a2c2e90e3",
                    "statuses": [
                      {
                        "id": "a",
                        "status": "verified",
                        "start": 0,
                        "end": 10
                      },
                      {
                        "id": "b",
                        "status": "verified",
                        "start": 6,
                        "end": 16
                      }
                    ],
                    "coverage": {
                      "sourceCodeUnits": 16,
                      "coveredCodeUnits": 16,
                      "uncoveredCodeUnits": 0,
                      "overlapCodeUnits": 4,
                      "maxDepth": 2
                    },
                    "uncoveredRanges": [],
                    "overlapRanges": [
                      {
                        "start": 6,
                        "end": 10,
                        "depth": 2
                      }
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "59c3081b39fdd0d1ef5e92076e1b1c3d94fcaa08cc2e15812f54899641206e40",
                    "outputSha256": "b3decc82c492c41aad32fe3b5ac6e6e3cf20184f05ced3d5b32faeb010d8cd72",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-document-extract": {
      "post": {
        "operationId": "mpp_json_document_extract",
        "summary": "Strict JSON Artifact Extraction",
        "description": "Extract exact JSON object/array candidates from caller-supplied text using explicit json-fence or balanced-container mode. Selects only one unambiguous valid candidate, rejects duplicate decoded keys and nonfinite numbers, and never repairs invalid JSON or executes content.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-document-extract.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Recover a strict JSON object from a model response with source-span evidence",
            "Reject ambiguous structured outputs instead of choosing the first JSON block"
          ],
          "whenToUse": [
            "Recover a strict JSON object from a model response with source-span evidence",
            "Reject ambiguous structured outputs instead of choosing the first JSON block"
          ],
          "whenNotToUse": [
            "JSON repair, JSON5, primitive JSON roots, schema validation or interpreting prose",
            "Guaranteed distinction between literal braces in prose and intended JSON in balanced mode"
          ],
          "capabilities": [
            "Case-sensitive json-labelled backtick/tilde fences; other fenced languages ignored",
            "Balanced mode respects JSON strings inside candidate containers",
            "Any malformed candidate or unmatched close blocks selection; multiple valid candidates are ambiguous",
            "Duplicate decoded keys, unsafe keys, unpaired surrogates and nonfinite numbers rejected"
          ],
          "related": [
            "json-schema-check",
            "mcp-result-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 8000,
            "depth": 20,
            "findings": 200,
            "candidates": 20,
            "parsedJsonNodes": 8000,
            "lines": 10000,
            "jsonRepair": "none",
            "primitiveRoots": "unsupported"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "UNSAFE_KEY",
            "INVALID_UNICODE",
            "INVALID_NUMBER",
            "CANDIDATE_LIMIT",
            "LINE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 90000
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "json-fences",
                      "balanced-containers"
                    ]
                  }
                },
                "required": [
                  "text",
                  "mode"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Result:\n```json\n{\"approved\":true,\"items\":[1,2]}\n```\n",
                "mode": "json-fences"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-document-extract",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "exact-json-container-extraction-v1"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "selected",
                            "none",
                            "ambiguous",
                            "invalid"
                          ]
                        },
                        "selected": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "start": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "end": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "value": {
                                  "$ref": "#/paths/~1v1~1mpp~1json-document-extract/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                }
                              },
                              "required": [
                                "start",
                                "end",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "candidates": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "valid": {
                                "type": "boolean"
                              },
                              "value": {
                                "$ref": "#/paths/~1v1~1mpp~1json-document-extract/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              },
                              "errorCode": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "valid",
                              "value",
                              "errorCode"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "candidateCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "findings": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "code",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "selected",
                        "candidates",
                        "candidateCount",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-document-extract/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-document-extract/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-document-extract",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-json-container-extraction-v1",
                    "status": "selected",
                    "selected": {
                      "start": 16,
                      "end": 47,
                      "value": {
                        "approved": true,
                        "items": [
                          1,
                          2
                        ]
                      }
                    },
                    "candidates": [
                      {
                        "start": 16,
                        "end": 47,
                        "valid": true,
                        "value": {
                          "approved": true,
                          "items": [
                            1,
                            2
                          ]
                        },
                        "errorCode": null
                      }
                    ],
                    "candidateCount": 1,
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "735ea43dca3f31b041cd1e74c267c918a2de412c0f44fdfff7541b2286b214e1",
                    "outputSha256": "e7e8de0d5cc2af865f62303ee36cd38d45b5ad7104fa401b28fee59c8b308476",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-repair": {
      "post": {
        "operationId": "mpp_json_repair",
        "summary": "Conservative JSON Repair Batch",
        "description": "Repair 1–5 supplied JSON-like texts under an explicit conservative grammar: comments, trailing commas, ASCII unquoted keys, single quotes, Python True/False/None, leading BOM and one enclosing JSON fence. Return unchanged originals, repaired text, parsed values, exact edit traces and independent item rejections. No missing values, delimiters or truncated data are inferred.",
        "tags": [
          "document-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-repair.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Repair bounded malformed JSON with an exact edit trace",
            "Batch up to five independent JSON syntax repairs"
          ],
          "whenToUse": [
            "Repair known syntactic defects in caller-supplied JSON-like text",
            "Preserve original text and inspect every change before trusting a structured artifact"
          ],
          "whenNotToUse": [
            "Arbitrary JSON5 or Python parsing, schema validation, semantic correction or guaranteed repair",
            "Completing truncated values, guessing missing delimiters or selecting duplicate keys",
            "Large documents, arbitrary-precision numbers or a cheapest single-call guarantee"
          ],
          "capabilities": [
            "One fixed proposed price for 1–5 items with independent success/rejected results",
            "Explicit repair profile and complete nonoverlapping original-coordinate UTF-16 edits",
            "Preserves valid number tokens and unchanged valid JSON text; rejects unsafe or decimal-round-trip-changing numbers",
            "Rejects decoded duplicate/reserved keys and invalid Unicode; never executes supplied text"
          ],
          "limits": {
            "items": 5,
            "textCodeUnitsPerItem": 16000,
            "inputBytes": 100000,
            "outputBytes": 400000,
            "nodesPerItem": 4000,
            "depth": 20,
            "editsPerItem": 200,
            "numberTokenCodeUnits": 256,
            "profile": "conservative-json-repair-v1",
            "offsetUnit": "utf16-code-units",
            "networkAccess": "none",
            "schemaValidation": "not-performed"
          },
          "related": [
            "json-document-extract",
            "json-schema-check",
            "json-canonicalize"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "DUPLICATE_ID",
            "EDIT_LIMIT",
            "COMPLEXITY_LIMIT",
            "NUMBER_LIMIT",
            "NON_FINITE_NUMBER",
            "UNSAFE_INTEGER",
            "NUMBER_PRECISION",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_KEY",
            "UNSUPPORTED_FENCE",
            "UNTERMINATED_COMMENT",
            "UNSUPPORTED_COMMENT",
            "INVALID_STRING",
            "INVALID_ESCAPE",
            "TRUNCATED_STRING",
            "TRUNCATED_VALUE",
            "TRUNCATED_CONTAINER",
            "MISSING_COLON",
            "MISSING_COMMA",
            "UNSUPPORTED_KEY",
            "UNSUPPORTED_SYNTAX",
            "TRAILING_CONTENT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "string",
                    "const": "conservative-json-repair-v1"
                  },
                  "items": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80,
                          "pattern": "^[A-Za-z0-9_-]+$"
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 16000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "profile",
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile": "conservative-json-repair-v1",
                "items": [
                  {
                    "id": "paid-fixture",
                    "text": "{foo: 'bar', broken: true,}"
                  },
                  {
                    "id": "already-valid",
                    "text": "{\"items\":[1,2],\"ok\":true}"
                  },
                  {
                    "id": "truncated",
                    "text": "{\"name\":\"unfinished"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-repair",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "conservative-json-repair-v1"
                        },
                        "offsetUnit": {
                          "type": "string",
                          "const": "utf16-code-units"
                        },
                        "itemCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 5
                        },
                        "successCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "rejectedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "results": {
                          "minItems": 1,
                          "maxItems": 5,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 80,
                                    "pattern": "^[A-Za-z0-9_-]+$"
                                  },
                                  "originalText": {
                                    "type": "string"
                                  },
                                  "status": {
                                    "type": "string",
                                    "enum": [
                                      "repaired",
                                      "unchanged"
                                    ]
                                  },
                                  "originalSha256": {
                                    "type": "string",
                                    "pattern": "^[a-f0-9]{64}$"
                                  },
                                  "originalWasValidJson": {
                                    "type": "boolean"
                                  },
                                  "repairedText": {
                                    "type": "string"
                                  },
                                  "repairedSha256": {
                                    "type": "string",
                                    "pattern": "^[a-f0-9]{64}$"
                                  },
                                  "value": {
                                    "$ref": "#/paths/~1v1~1mpp~1json-repair/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  },
                                  "edits": {
                                    "maxItems": 200,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "enum": [
                                            "remove-bom",
                                            "remove-fence",
                                            "replace-comment",
                                            "remove-trailing-comma",
                                            "quote-key",
                                            "convert-single-quoted-string",
                                            "convert-python-literal"
                                          ]
                                        },
                                        "start": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "end": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        },
                                        "before": {
                                          "type": "string"
                                        },
                                        "after": {
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "start",
                                        "end",
                                        "before",
                                        "after"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "originalText",
                                  "status",
                                  "originalSha256",
                                  "originalWasValidJson",
                                  "repairedText",
                                  "repairedSha256",
                                  "value",
                                  "edits"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 80,
                                    "pattern": "^[A-Za-z0-9_-]+$"
                                  },
                                  "originalText": {
                                    "type": "string"
                                  },
                                  "status": {
                                    "type": "string",
                                    "const": "rejected"
                                  },
                                  "originalSha256": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "pattern": "^[a-f0-9]{64}$"
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "error": {
                                    "type": "object",
                                    "properties": {
                                      "code": {
                                        "type": "string"
                                      },
                                      "message": {
                                        "type": "string"
                                      },
                                      "offset": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "code",
                                      "message",
                                      "offset"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "required": [
                                  "id",
                                  "originalText",
                                  "status",
                                  "originalSha256",
                                  "error"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "offsetUnit",
                        "itemCount",
                        "successCount",
                        "rejectedCount",
                        "results"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-repair/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-repair/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-repair",
                  "version": "0.29.0",
                  "result": {
                    "profile": "conservative-json-repair-v1",
                    "offsetUnit": "utf16-code-units",
                    "itemCount": 3,
                    "successCount": 2,
                    "rejectedCount": 1,
                    "results": [
                      {
                        "id": "paid-fixture",
                        "originalText": "{foo: 'bar', broken: true,}",
                        "status": "repaired",
                        "originalSha256": "180949792a87351e726ae3e5ea90bfa3ecf362028e987b6edce90abe359c0b2f",
                        "originalWasValidJson": false,
                        "repairedText": "{\"foo\": \"bar\", \"broken\": true}",
                        "repairedSha256": "a5640e8bcad859bf34dc8849af8f22a455c7dbd86f81a83287666b3dc0bb6eeb",
                        "value": {
                          "foo": "bar",
                          "broken": true
                        },
                        "edits": [
                          {
                            "kind": "quote-key",
                            "start": 1,
                            "end": 4,
                            "before": "foo",
                            "after": "\"foo\""
                          },
                          {
                            "kind": "convert-single-quoted-string",
                            "start": 6,
                            "end": 11,
                            "before": "'bar'",
                            "after": "\"bar\""
                          },
                          {
                            "kind": "quote-key",
                            "start": 13,
                            "end": 19,
                            "before": "broken",
                            "after": "\"broken\""
                          },
                          {
                            "kind": "remove-trailing-comma",
                            "start": 25,
                            "end": 26,
                            "before": ",",
                            "after": ""
                          }
                        ]
                      },
                      {
                        "id": "already-valid",
                        "originalText": "{\"items\":[1,2],\"ok\":true}",
                        "status": "unchanged",
                        "originalSha256": "067816002380371fc6726553d6797b9cddfb32289bc801f9a82612f09f74e5d4",
                        "originalWasValidJson": true,
                        "repairedText": "{\"items\":[1,2],\"ok\":true}",
                        "repairedSha256": "067816002380371fc6726553d6797b9cddfb32289bc801f9a82612f09f74e5d4",
                        "value": {
                          "items": [
                            1,
                            2
                          ],
                          "ok": true
                        },
                        "edits": []
                      },
                      {
                        "id": "truncated",
                        "originalText": "{\"name\":\"unfinished",
                        "status": "rejected",
                        "originalSha256": "24f03ddd7eff759bda2f2f10cae68b37cc828cf219b149b3011577819c32b8f3",
                        "error": {
                          "code": "TRUNCATED_STRING",
                          "message": "Missing string closing quote; no value is inferred",
                          "offset": 8
                        }
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "a2c462b8c4f3bb0e6a6b0c6f4d34ad90507da1a4e1b48ac23a5d571ef2802b46",
                    "outputSha256": "6aa3bc1bf9fbc05627e4cf7534f8e8bf280ca6614eb13213262cf2e6479987dc",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/timezone-convert": {
      "post": {
        "operationId": "mpp_timezone_convert",
        "summary": "UTC instant to IANA time zones",
        "description": "Convert one explicit UTC instant into 1–10 IANA zone local times and exact UTC offsets, including the runtime's daylight-saving transitions. No wall-time guessing, current-clock lookup, recurrence or DST boolean. Runtime tzdb version is not exposed.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/timezone-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "convert UTC instant to IANA time zones",
            "batch timezone conversion",
            "UTC local time daylight saving offset",
            "format instant in multiple zones"
          ],
          "whenToUse": [
            "Convert one supplied UTC instant to 1–10 local representations with second-accurate offsets under the installed runtime IANA data."
          ],
          "whenNotToUse": [
            "Resolve an ambiguous or nonexistent local wall time, infer a city or abbreviation, fetch current time, classify DST with a boolean, schedule recurring events, or guarantee historical/future political time-zone rules."
          ],
          "capabilities": [
            "UTC instant",
            "IANA time zones",
            "batch zone conversion",
            "local date and time",
            "daylight-saving offset transitions",
            "fractional-hour offsets"
          ],
          "related": [
            "timestamp-convert",
            "duration-convert"
          ],
          "limits": {
            "zones": 10,
            "zoneCodeUnits": 64,
            "outputBytes": 16000,
            "earliestUtc": "1970-01-01T00:00:00.000Z",
            "latestUtc": "2100-12-31T23:59:59.999Z",
            "precision": "milliseconds",
            "tzdbVersion": "not exposed; depends on runtime"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_INSTANT",
            "DUPLICATE_TIME_ZONE",
            "UNSUPPORTED_TIME_ZONE",
            "TIME_ZONE_RUNTIME_ERROR"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "string",
                    "const": "utc-instant-iana-batch-v1"
                  },
                  "instant": {
                    "type": "string",
                    "minLength": 20,
                    "maxLength": 24,
                    "pattern": "^(?:19[7-9]\\d|20\\d{2}|2100)-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?Z$"
                  },
                  "zones": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64,
                      "pattern": "^(?:UTC|[A-Za-z][A-Za-z0-9._+-]*(?:\\/[A-Za-z0-9._+-]+)+)$"
                    }
                  }
                },
                "required": [
                  "profile",
                  "instant",
                  "zones"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile": "utc-instant-iana-batch-v1",
                "instant": "2026-07-01T12:00:00Z",
                "zones": [
                  "America/New_York",
                  "Europe/London",
                  "Asia/Kolkata",
                  "Pacific/Auckland"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "timezone-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "utc-instant-iana-batch-v1"
                        },
                        "instant": {
                          "type": "string",
                          "format": "date-time",
                          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
                        },
                        "epochMilliseconds": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "zoneCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10
                        },
                        "rulesSource": {
                          "type": "string",
                          "const": "runtime-intl-iana"
                        },
                        "tzdbVersion": {
                          "type": "null"
                        },
                        "dstPolicy": {
                          "type": "string",
                          "const": "offset-at-instant; no-heuristic-DST-classification"
                        },
                        "results": {
                          "minItems": 1,
                          "maxItems": 10,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "requestedZone": {
                                "type": "string",
                                "maxLength": 64
                              },
                              "resolvedZone": {
                                "type": "string",
                                "maxLength": 64
                              },
                              "localDateTime": {
                                "type": "string",
                                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}$"
                              },
                              "utcOffset": {
                                "type": "string",
                                "pattern": "^[+-]\\d{2}:\\d{2}(?::\\d{2})?$"
                              },
                              "utcOffsetSeconds": {
                                "type": "integer",
                                "minimum": -86400,
                                "maximum": 86400
                              },
                              "zonedDateTime": {
                                "type": "string",
                                "maxLength": 110
                              }
                            },
                            "required": [
                              "requestedZone",
                              "resolvedZone",
                              "localDateTime",
                              "utcOffset",
                              "utcOffsetSeconds",
                              "zonedDateTime"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "instant",
                        "epochMilliseconds",
                        "zoneCount",
                        "rulesSource",
                        "tzdbVersion",
                        "dstPolicy",
                        "results"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "timezone-convert",
                  "version": "0.29.0",
                  "result": {
                    "profile": "utc-instant-iana-batch-v1",
                    "instant": "2026-07-01T12:00:00.000Z",
                    "epochMilliseconds": 1782907200000,
                    "zoneCount": 4,
                    "rulesSource": "runtime-intl-iana",
                    "tzdbVersion": null,
                    "dstPolicy": "offset-at-instant; no-heuristic-DST-classification",
                    "results": [
                      {
                        "requestedZone": "America/New_York",
                        "resolvedZone": "America/New_York",
                        "localDateTime": "2026-07-01T08:00:00.000",
                        "utcOffset": "-04:00",
                        "utcOffsetSeconds": -14400,
                        "zonedDateTime": "2026-07-01T08:00:00.000-04:00[America/New_York]"
                      },
                      {
                        "requestedZone": "Europe/London",
                        "resolvedZone": "Europe/London",
                        "localDateTime": "2026-07-01T13:00:00.000",
                        "utcOffset": "+01:00",
                        "utcOffsetSeconds": 3600,
                        "zonedDateTime": "2026-07-01T13:00:00.000+01:00[Europe/London]"
                      },
                      {
                        "requestedZone": "Asia/Kolkata",
                        "resolvedZone": "Asia/Calcutta",
                        "localDateTime": "2026-07-01T17:30:00.000",
                        "utcOffset": "+05:30",
                        "utcOffsetSeconds": 19800,
                        "zonedDateTime": "2026-07-01T17:30:00.000+05:30[Asia/Calcutta]"
                      },
                      {
                        "requestedZone": "Pacific/Auckland",
                        "resolvedZone": "Pacific/Auckland",
                        "localDateTime": "2026-07-02T00:00:00.000",
                        "utcOffset": "+12:00",
                        "utcOffsetSeconds": 43200,
                        "zonedDateTime": "2026-07-02T00:00:00.000+12:00[Pacific/Auckland]"
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "599c99deae8e260cb7e847cb1c355c412a58e9ff9edb355b6e066d7edef1705a",
                    "outputSha256": "2badc1e493bca94a8e8ab528c7a960ccc6cde822748d705f5bab5e405bb5f6c8",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/blob-decode": {
      "post": {
        "operationId": "mpp_blob_decode",
        "summary": "Bounded compressed blob batch decoding",
        "description": "Decode 1–10 inline canonical Base64 gzip or zlib-wrapped deflate blobs to strict UTF-8 or Base64 bytes. Streaming aggregate input/output and per-item expansion caps. No Brotli, archive extraction, remote fetch, nested decoding or content interpretation.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/blob-decode.md"
        },
        "x-agent-discovery": {
          "intents": [
            "batch decode compressed blobs",
            "decompress gzip Base64 payload",
            "decode zlib deflate data",
            "bounded binary payload decompression"
          ],
          "whenToUse": [
            "Decode 1–10 supplied gzip or zlib-wrapped deflate blobs under a combined 32 KiB compressed / 64 KiB decoded budget, retaining strict text or binary bytes."
          ],
          "whenNotToUse": [
            "Brotli, raw deflate, ZIP/TAR archives, multiple gzip members, compression autodetection, external files or URLs, dictionaries, nested decoding, JSON parsing, code execution or large/high-ratio payloads."
          ],
          "capabilities": [
            "gzip decompression",
            "zlib deflate decompression",
            "canonical Base64 input",
            "strict UTF-8",
            "binary Base64 output",
            "batch decoding",
            "streaming output limits"
          ],
          "related": [
            "base64-convert",
            "content-digest",
            "json-repair"
          ],
          "limits": {
            "items": 10,
            "compressedBytes": 32768,
            "decodedBytes": 65536,
            "expansionRatio": 100,
            "inputChunkBytes": 256,
            "base64CodeUnitsPerItem": 43692,
            "outputBytes": 410000,
            "outputLimitScope": "aggregate across all batch items",
            "ratioLimitScope": "per item, decompressed bytes / total compressed bytes",
            "codecs": "gzip single member; zlib-wrapped deflate"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "DUPLICATE_ID",
            "NONCANONICAL_BASE64",
            "COMPRESSED_INPUT_LIMIT",
            "DECOMPRESSION_LIMIT",
            "INVALID_COMPRESSED_DATA",
            "INVALID_UTF8",
            "OUTPUT_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "string",
                    "const": "bounded-compressed-blob-batch-v1"
                  },
                  "items": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80,
                          "pattern": "^[A-Za-z0-9_-]+$"
                        },
                        "compression": {
                          "type": "string",
                          "enum": [
                            "gzip",
                            "deflate"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "minLength": 4,
                          "maxLength": 43692,
                          "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$"
                        },
                        "outputEncoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "compression",
                        "data",
                        "outputEncoding"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "profile",
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile": "bounded-compressed-blob-batch-v1",
                "items": [
                  {
                    "id": "message",
                    "compression": "gzip",
                    "data": "H4sIAAAAAAAAA8tIzcnJBwCGphA2BQAAAA==",
                    "outputEncoding": "utf8"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "blob-decode",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "bounded-compressed-blob-batch-v1"
                        },
                        "itemCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 10
                        },
                        "totalCompressedBytes": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 32768
                        },
                        "totalDecodedBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 65536
                        },
                        "results": {
                          "minItems": 1,
                          "maxItems": 10,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "compression": {
                                "type": "string",
                                "enum": [
                                  "gzip",
                                  "deflate"
                                ]
                              },
                              "outputEncoding": {
                                "type": "string",
                                "enum": [
                                  "utf8",
                                  "base64"
                                ]
                              },
                              "compressedBytes": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 32768
                              },
                              "decodedBytes": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 65536
                              },
                              "expansionRatio": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 100
                              },
                              "decodedSha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "data": {
                                "type": "string",
                                "maxLength": 87384
                              }
                            },
                            "required": [
                              "id",
                              "compression",
                              "outputEncoding",
                              "compressedBytes",
                              "decodedBytes",
                              "expansionRatio",
                              "decodedSha256",
                              "data"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "itemCount",
                        "totalCompressedBytes",
                        "totalDecodedBytes",
                        "results"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "blob-decode",
                  "version": "0.29.0",
                  "result": {
                    "profile": "bounded-compressed-blob-batch-v1",
                    "itemCount": 1,
                    "totalCompressedBytes": 25,
                    "totalDecodedBytes": 5,
                    "results": [
                      {
                        "id": "message",
                        "compression": "gzip",
                        "outputEncoding": "utf8",
                        "compressedBytes": 25,
                        "decodedBytes": 5,
                        "expansionRatio": 0.2,
                        "decodedSha256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
                        "data": "hello"
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "a928ecf9b5fc113ec31a216e63971729f4ccace245c3095f1b95ded834981ec0",
                    "outputSha256": "637ff52e4d85f31c2d1d2b262dedd5f1bbfc28107236408b6209e158077ca55d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/dockerfile-audit": {
      "post": {
        "operationId": "mpp_dockerfile_audit",
        "summary": "Bounded Dockerfile static audit",
        "description": "Inspect one supplied Dockerfile for 14 bounded static risk and hygiene signals with line ranges, rule IDs, redacted evidence and remediation. Understands continuations, escape directives, literal stage inheritance and JSON forms. No execution, image/CVE scan, fetch, variable evaluation or safe-image verdict; heredocs, ONBUILD and custom frontends are rejected.",
        "tags": [
          "supply-chain"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/dockerfile-audit.md"
        },
        "x-agent-discovery": {
          "intents": [
            "audit supplied Dockerfile text",
            "Dockerfile static risk analysis",
            "lint Dockerfile build hygiene",
            "review Dockerfile base image pinning and runtime user"
          ],
          "whenToUse": [
            "Get bounded static observations about one supplied Dockerfile's literal image references, stage/user configuration, COPY/ADD sources, secret-like names and instruction forms."
          ],
          "whenNotToUse": [
            "Build or execute a Dockerfile, inspect an image or registry, find CVEs, certify security, analyze Compose/Kubernetes, evaluate shell commands or ARG values, or parse heredocs, ONBUILD or custom syntax frontends."
          ],
          "capabilities": [
            "supplied Dockerfile",
            "line-numbered findings",
            "static audit",
            "multi-stage build",
            "base image digest pinning",
            "root USER signal",
            "secret-like variable names",
            "redacted evidence",
            "COPY ADD review"
          ],
          "limits": {
            "inputCodeUnits": 65536,
            "dockerfileUtf8Bytes": 65536,
            "physicalLines": 2048,
            "instructions": 512,
            "instructionCodeUnits": 8192,
            "stages": 64,
            "findings": 128,
            "outputBytes": 180000,
            "rules": 14,
            "variableEvaluation": "none",
            "sourceEcho": "none",
            "externalRequests": 0,
            "shellAnalysis": "none"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_DOCKERFILE",
            "UNSUPPORTED_DOCKERFILE_SYNTAX",
            "DOCKERFILE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "string",
                    "const": "bounded-dockerfile-static-v1"
                  },
                  "dockerfile": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 65536
                  }
                },
                "required": [
                  "profile",
                  "dockerfile"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile": "bounded-dockerfile-static-v1",
                "dockerfile": "FROM node:22 AS build\nWORKDIR /app\nCOPY . .\nRUN npm ci\nFROM node:22-slim\nCOPY --from=build /app /app\nUSER 1000:1000\nENTRYPOINT [\"node\", \"/app/server.js\"]\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "dockerfile-audit",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "bounded-dockerfile-static-v1"
                        },
                        "analysis": {
                          "type": "string",
                          "const": "bounded-static-observations"
                        },
                        "inputBytes": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 65536
                        },
                        "physicalLines": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 2048
                        },
                        "instructionCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 512
                        },
                        "finalStageIndex": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 63
                        },
                        "stages": {
                          "minItems": 1,
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 63
                              },
                              "fromLine": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              "endLine": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              "baseKind": {
                                "type": "string",
                                "enum": [
                                  "external-image",
                                  "prior-stage",
                                  "scratch",
                                  "variable-dependent"
                                ]
                              },
                              "digestPinned": {
                                "type": [
                                  "boolean",
                                  "null"
                                ]
                              },
                              "runtimeUser": {
                                "type": "string",
                                "enum": [
                                  "explicit-root",
                                  "explicit-nonroot",
                                  "named-user-unknown",
                                  "base-unknown",
                                  "variable-dependent"
                                ]
                              },
                              "userSourceLine": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "exclusiveMinimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "index",
                              "fromLine",
                              "endLine",
                              "baseKind",
                              "digestPinned",
                              "runtimeUser",
                              "userSourceLine"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "rulesEvaluated": {
                          "minItems": 14,
                          "maxItems": 14,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "DF001",
                              "DF002",
                              "DF003",
                              "DF004",
                              "DF005",
                              "DF006",
                              "DF007",
                              "DF008",
                              "DF009",
                              "DF010",
                              "DF011",
                              "DF012",
                              "DF013",
                              "DF014"
                            ]
                          }
                        },
                        "findings": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "ruleId": {
                                "type": "string",
                                "enum": [
                                  "DF001",
                                  "DF002",
                                  "DF003",
                                  "DF004",
                                  "DF005",
                                  "DF006",
                                  "DF007",
                                  "DF008",
                                  "DF009",
                                  "DF010",
                                  "DF011",
                                  "DF012",
                                  "DF013",
                                  "DF014"
                                ]
                              },
                              "severity": {
                                "type": "string",
                                "enum": [
                                  "info",
                                  "warning"
                                ]
                              },
                              "category": {
                                "type": "string",
                                "enum": [
                                  "reproducibility",
                                  "security-configuration",
                                  "build-hygiene",
                                  "portability"
                                ]
                              },
                              "confidence": {
                                "type": "string",
                                "enum": [
                                  "syntactic",
                                  "heuristic"
                                ]
                              },
                              "line": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              "endLine": {
                                "type": "integer",
                                "exclusiveMinimum": 0,
                                "maximum": 9007199254740991
                              },
                              "stageIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "evidence": {
                                "type": "string",
                                "maxLength": 180
                              },
                              "message": {
                                "type": "string",
                                "maxLength": 300
                              },
                              "remediation": {
                                "type": "string",
                                "maxLength": 400
                              }
                            },
                            "required": [
                              "ruleId",
                              "severity",
                              "category",
                              "confidence",
                              "line",
                              "endLine",
                              "stageIndex",
                              "evidence",
                              "message",
                              "remediation"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "summary": {
                          "type": "object",
                          "properties": {
                            "totalFindings": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "returnedFindings": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 128
                            },
                            "bySeverity": {
                              "type": "object",
                              "properties": {
                                "info": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                "warning": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "info",
                                "warning"
                              ],
                              "additionalProperties": false
                            },
                            "truncated": {
                              "type": "boolean"
                            },
                            "variableDependentInstructions": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "totalFindings",
                            "returnedFindings",
                            "bySeverity",
                            "truncated",
                            "variableDependentInstructions"
                          ],
                          "additionalProperties": false
                        },
                        "limitations": {
                          "minItems": 1,
                          "maxItems": 12,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 350
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "analysis",
                        "inputBytes",
                        "physicalLines",
                        "instructionCount",
                        "finalStageIndex",
                        "stages",
                        "rulesEvaluated",
                        "findings",
                        "summary",
                        "limitations"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "dockerfile-audit",
                  "version": "0.29.0",
                  "result": {
                    "profile": "bounded-dockerfile-static-v1",
                    "analysis": "bounded-static-observations",
                    "inputBytes": 154,
                    "physicalLines": 8,
                    "instructionCount": 8,
                    "finalStageIndex": 1,
                    "stages": [
                      {
                        "index": 0,
                        "fromLine": 1,
                        "endLine": 4,
                        "baseKind": "external-image",
                        "digestPinned": false,
                        "runtimeUser": "base-unknown",
                        "userSourceLine": null
                      },
                      {
                        "index": 1,
                        "fromLine": 5,
                        "endLine": 8,
                        "baseKind": "external-image",
                        "digestPinned": false,
                        "runtimeUser": "explicit-nonroot",
                        "userSourceLine": 7
                      }
                    ],
                    "rulesEvaluated": [
                      "DF001",
                      "DF002",
                      "DF003",
                      "DF004",
                      "DF005",
                      "DF006",
                      "DF007",
                      "DF008",
                      "DF009",
                      "DF010",
                      "DF011",
                      "DF012",
                      "DF013",
                      "DF014"
                    ],
                    "findings": [
                      {
                        "ruleId": "DF002",
                        "severity": "info",
                        "category": "reproducibility",
                        "confidence": "syntactic",
                        "line": 1,
                        "endLine": 1,
                        "stageIndex": 0,
                        "evidence": "FROM external image: explicit tag, no sha256 digest",
                        "message": "External base image has a tag but no digest pin.",
                        "remediation": "Consider pinning a verified digest for reproducibility; arrange updates so pinning does not indefinitely prevent security fixes."
                      },
                      {
                        "ruleId": "DF007",
                        "severity": "info",
                        "category": "build-hygiene",
                        "confidence": "syntactic",
                        "line": 3,
                        "endLine": 3,
                        "stageIndex": 0,
                        "evidence": "COPY includes a literal whole-context source; ignore rules not inspected",
                        "message": "A local COPY or ADD source includes the context root or a whole-context wildcard.",
                        "remediation": "Review .dockerignore and prefer the required paths. Context contents and ignore rules were not supplied, so accidental inclusion is not established."
                      },
                      {
                        "ruleId": "DF002",
                        "severity": "info",
                        "category": "reproducibility",
                        "confidence": "syntactic",
                        "line": 5,
                        "endLine": 5,
                        "stageIndex": 1,
                        "evidence": "FROM external image: explicit tag, no sha256 digest",
                        "message": "External base image has a tag but no digest pin.",
                        "remediation": "Consider pinning a verified digest for reproducibility; arrange updates so pinning does not indefinitely prevent security fixes."
                      }
                    ],
                    "summary": {
                      "totalFindings": 3,
                      "returnedFindings": 3,
                      "bySeverity": {
                        "info": 3,
                        "warning": 0
                      },
                      "truncated": false,
                      "variableDependentInstructions": 0
                    },
                    "limitations": [
                      "Static observations only: no build, command execution, filesystem access, network requests, registry lookup, vulnerability scan or safety verdict.",
                      "Base-image metadata, runtime overrides, build arguments, named contexts, .dockerignore and source files are not available. Variable expressions are not evaluated, including ARG defaults.",
                      "Shell programs and package-install commands are opaque. No shell correctness, package pinning or script security analysis is performed.",
                      "Recognized instructions without a listed rule are retained for structure only. This is not a complete Docker parser, compiler or build-success check.",
                      "Heredocs, ONBUILD, custom/labs frontends, unknown instructions/flags, ambiguous terminal escapes and malformed supported forms are rejected rather than partially interpreted.",
                      "Findings are potential issues to review. Secret checks use names only; values, source snippets, image references and URLs are not echoed. A report with no findings does not establish safety.",
                      "The final stage is the last textual FROM; --target selection is not an input. Rules inspect all textual stages, including stages a build might skip. Docker #check suppressions do not suppress this profile's rules."
                    ]
                  },
                  "provenance": {
                    "inputSha256": "da6f61385220259b52108217ce4cdf1b3ba1cca6ab6e6fc3a888dfc8b17095dc",
                    "outputSha256": "590de60e78b37fc2620732486c55052fcc81de4436e975f6161100084cbcab00",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/records-join": {
      "post": {
        "operationId": "mpp_records_join",
        "summary": "Typed guarded record join",
        "description": "WHEN TO USE: Produce actual inner, left or full joined row pairs from two supplied tables using typed scalar JSON Pointer keys. Enforces declared cardinality over both complete inputs before matching; duplicate null-containing keys count for uniqueness even when nullKeys=never-match. Preserves provenance and order, rejects fanout overruns without partial output. No coercion, fuzzy matching, database access or semantic relationship verification.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-join.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Join two tables while retaining source rows and indexes",
            "Enrich records with a typed lookup and guard duplicate keys",
            "Build inner left or full joins with explicit many-to-many fanout"
          ],
          "whenToUse": [
            "Join two tables while retaining source rows and indexes",
            "Enrich records with a typed lookup and guard duplicate keys",
            "Build inner left or full joins with explicit many-to-many fanout"
          ],
          "whenNotToUse": [
            "Fuzzy or semantic entity matching, coercing scalar keys, or proving a business relationship",
            "Silently combining colliding columns or truncating a join to fit a cap",
            "Fetching data, executing caller code, contacting agents, transmitting a payload, or changing remote state",
            "Verifying semantic truth, source authenticity, identity, permissions, or business relationships"
          ],
          "capabilities": [
            "Typed composite scalar keys distinguish number, string, boolean and null",
            "Checks declared uniqueness over entire inputs including unmatched and null-containing keys",
            "Preflights all output row cardinality; stable left/right provenance pairs",
            "Networkless deterministic transforms; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "maxRowsPerSide": 500,
            "maxKeyPairs": 5,
            "maxPointerSegments": 20,
            "maxOutputRows": 2000,
            "nullUniqueness": "null-containing keys count toward uniqueness"
          },
          "related": [
            "record-relations",
            "records-project",
            "records-filter"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_POINTER",
            "MISSING_KEY",
            "INVALID_KEY",
            "CARDINALITY_VIOLATION",
            "OUTPUT_ROW_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "left": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1records-join/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "right": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1records-join/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "keys": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "left": {
                          "type": "string",
                          "maxLength": 2048,
                          "description": "RFC 6901 string pointer, at most 20 segments. Empty pointer selects the row object, which is not a scalar join key. No URI fragments or reserved property segments."
                        },
                        "right": {
                          "type": "string",
                          "maxLength": 2048,
                          "description": "RFC 6901 string pointer, at most 20 segments. Empty pointer selects the row object, which is not a scalar join key. No URI fragments or reserved property segments."
                        }
                      },
                      "required": [
                        "left",
                        "right"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "inner",
                      "left",
                      "full"
                    ]
                  },
                  "cardinality": {
                    "default": "many-to-one",
                    "type": "string",
                    "enum": [
                      "one-to-one",
                      "many-to-one",
                      "many-to-many"
                    ]
                  },
                  "nullKeys": {
                    "default": "never-match",
                    "type": "string",
                    "enum": [
                      "never-match",
                      "match"
                    ]
                  },
                  "maxOutputRows": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 2000
                  }
                },
                "required": [
                  "left",
                  "right",
                  "keys",
                  "kind",
                  "maxOutputRows"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1records-join/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1records-join/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "left": [
                  {
                    "sku": "A",
                    "qty": 2
                  },
                  {
                    "sku": "B",
                    "qty": 1
                  }
                ],
                "right": [
                  {
                    "code": "A",
                    "label": "Adapters"
                  }
                ],
                "keys": [
                  {
                    "left": "/sku",
                    "right": "/code"
                  }
                ],
                "kind": "left",
                "cardinality": "many-to-one",
                "nullKeys": "never-match",
                "maxOutputRows": 10
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-join",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "typed-records-join-v1"
                        },
                        "kind": {
                          "type": "string",
                          "enum": [
                            "inner",
                            "left",
                            "full"
                          ]
                        },
                        "cardinality": {
                          "type": "string",
                          "enum": [
                            "one-to-one",
                            "many-to-one",
                            "many-to-many"
                          ]
                        },
                        "nullKeys": {
                          "type": "string",
                          "enum": [
                            "never-match",
                            "match"
                          ]
                        },
                        "rows": {
                          "maxItems": 2000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "leftIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 499
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "rightIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 499
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "left": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/paths/~1v1~1mpp~1records-join/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "right": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/paths/~1v1~1mpp~1records-join/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "leftIndex",
                              "rightIndex",
                              "left",
                              "right"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "outputRows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matchedLeftRows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "unmatchedLeftRows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "matchedRightRows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "unmatchedRightRows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "kind",
                        "cardinality",
                        "nullKeys",
                        "rows",
                        "outputRows",
                        "matchedLeftRows",
                        "unmatchedLeftRows",
                        "matchedRightRows",
                        "unmatchedRightRows",
                        "externalRequests",
                        "semanticValidityVerified"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1records-join/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1records-join/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-join",
                  "version": "0.29.0",
                  "result": {
                    "profile": "typed-records-join-v1",
                    "kind": "left",
                    "cardinality": "many-to-one",
                    "nullKeys": "never-match",
                    "rows": [
                      {
                        "leftIndex": 0,
                        "rightIndex": 0,
                        "left": {
                          "sku": "A",
                          "qty": 2
                        },
                        "right": {
                          "code": "A",
                          "label": "Adapters"
                        }
                      },
                      {
                        "leftIndex": 1,
                        "rightIndex": null,
                        "left": {
                          "sku": "B",
                          "qty": 1
                        },
                        "right": null
                      }
                    ],
                    "outputRows": 2,
                    "matchedLeftRows": 1,
                    "unmatchedLeftRows": 1,
                    "matchedRightRows": 1,
                    "unmatchedRightRows": 0,
                    "externalRequests": 0,
                    "semanticValidityVerified": false
                  },
                  "provenance": {
                    "inputSha256": "2a6e27489652f9ea391dd0820684e8a9690cbe8d4028b086ee11cdd12dc51022",
                    "outputSha256": "68a134752f33121788d4152199e9678ecea72b4e7e92ca50d19e0eb40fdbc57b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/localized-number-parse": {
      "post": {
        "operationId": "mpp_localized_number_parse",
        "summary": "Explicit localized number parser",
        "description": "WHEN TO USE: Convert supplied localized numeric spellings into exact ASCII decimal strings using a declared digit alphabet, symbols and primary/secondary grouping. Validates the entire spelling with per-item rejections; preserves fractional digit count and negative-zero evidence. No locale inference, floating-point numeric conversion, exponent/currency parsing or full CLDR claim. Maximum 200 items and 128 Unicode code points each.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/localized-number-parse.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Parse localized decimal strings with an explicit digit and separator profile",
            "Convert grouped Arabic-Indic or comma-decimal numbers without floating-point loss",
            "Reject partially parsed numbers and retain negative zero and fractional precision evidence"
          ],
          "whenToUse": [
            "Parse localized decimal strings with an explicit digit and separator profile",
            "Convert grouped Arabic-Indic or comma-decimal numbers without floating-point loss",
            "Reject partially parsed numbers and retain negative zero and fractional precision evidence"
          ],
          "whenNotToUse": [
            "Inferring a locale, full CLDR/ICU conformance, currency or percentage conversion, exponent notation or accounting parentheses",
            "Normalizing Unicode or repairing malformed numeric spellings",
            "Fetching data, executing caller code, contacting agents, transmitting a payload, or changing remote state",
            "Verifying semantic truth, source authenticity, identity, permissions, or business relationships"
          ],
          "capabilities": [
            "Exact ASCII decimal output, without JSON floating-point conversion",
            "Optional grouping with strict primary/secondary group widths and whole-string matching",
            "Item-level syntax rejection; invalid or ambiguous profiles reject the entire batch",
            "Networkless deterministic transforms; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "maxItems": 200,
            "maxTextCodePoints": 128,
            "digitAlphabetCodePoints": 10,
            "maxGroupWidth": 9,
            "trim": "none or leading/trailing U+0020 only",
            "numericOutput": "canonical ASCII decimal string"
          },
          "related": [
            "numeric-rounding-check",
            "csv-parse",
            "integer-apportion"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_PROFILE",
            "DUPLICATE_ID"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "object",
                    "properties": {
                      "decimal": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 2,
                        "description": "Exactly one Unicode scalar value; distinct from every digit and other enabled syntax symbol."
                      },
                      "group": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 2,
                            "description": "Exactly one Unicode scalar value; distinct from every digit and other enabled syntax symbol."
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "digits": {
                        "type": "string",
                        "minLength": 10,
                        "maxLength": 20,
                        "description": "Exactly ten distinct Unicode scalar values, in digit-value order zero through nine."
                      },
                      "primaryGroup": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 9
                      },
                      "secondaryGroup": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 9
                      },
                      "minus": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 2,
                            "description": "Exactly one Unicode scalar value; distinct from every digit and other enabled syntax symbol."
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "plus": {
                        "anyOf": [
                          {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 2,
                            "description": "Exactly one Unicode scalar value; distinct from every digit and other enabled syntax symbol."
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "trim": {
                        "type": "string",
                        "enum": [
                          "none",
                          "ascii-space"
                        ]
                      }
                    },
                    "required": [
                      "decimal",
                      "digits",
                      "primaryGroup",
                      "secondaryGroup",
                      "minus",
                      "plus",
                      "trim"
                    ],
                    "additionalProperties": false
                  },
                  "items": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 256,
                          "description": "At most 128 Unicode scalar values (up to 256 UTF-16 code units); complete numeric spelling required."
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "profile",
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile": {
                  "decimal": ",",
                  "group": ".",
                  "digits": "0123456789",
                  "primaryGroup": 3,
                  "secondaryGroup": 3,
                  "minus": "-",
                  "plus": "+",
                  "trim": "none"
                },
                "items": [
                  {
                    "id": "amount",
                    "text": "1.234,50"
                  },
                  {
                    "id": "bad",
                    "text": "12.34,50"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "localized-number-parse",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "explicit-localized-decimal-v1"
                        },
                        "items": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "status": {
                                    "type": "string",
                                    "const": "parsed"
                                  },
                                  "decimal": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 129,
                                    "pattern": "^-?(?:0|[1-9]\\d*)(?:\\.\\d*[1-9])?$"
                                  },
                                  "fractionDigits": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 127
                                  },
                                  "negativeZero": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "id",
                                  "status",
                                  "decimal",
                                  "fractionDigits",
                                  "negativeZero"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "status": {
                                    "type": "string",
                                    "const": "rejected"
                                  },
                                  "code": {
                                    "type": "string",
                                    "enum": [
                                      "EMPTY_NUMBER",
                                      "INVALID_DECIMAL",
                                      "INVALID_GROUPING",
                                      "INVALID_DIGIT"
                                    ]
                                  }
                                },
                                "required": [
                                  "id",
                                  "status",
                                  "code"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        },
                        "parsedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "rejectedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "items",
                        "parsedCount",
                        "rejectedCount",
                        "externalRequests",
                        "semanticValidityVerified"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "localized-number-parse",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-localized-decimal-v1",
                    "items": [
                      {
                        "id": "amount",
                        "status": "parsed",
                        "decimal": "1234.5",
                        "fractionDigits": 2,
                        "negativeZero": false
                      },
                      {
                        "id": "bad",
                        "status": "rejected",
                        "code": "INVALID_GROUPING"
                      }
                    ],
                    "parsedCount": 1,
                    "rejectedCount": 1,
                    "externalRequests": 0,
                    "semanticValidityVerified": false
                  },
                  "provenance": {
                    "inputSha256": "fed04dea67f41b2b280d65a04628f220b1990342b4b23286c7385e670866cf8a",
                    "outputSha256": "33f7fc6af42ba5fea58d25f6e6642910702fb70b6d7f6dbcbf15122d3ffd535a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-batch-encode": {
      "post": {
        "operationId": "mpp_json_batch_encode",
        "summary": "Exact UTF-8 JSON batch encoder",
        "description": "WHEN TO USE: Produce contiguous, greedy, byte-bounded JSON-array or LF-terminated NDJSON wire bodies from supplied JSON values. Counts actual UTF-8 bodies including framing and escaping; optional SHA-256 hashes those unchanged bytes. Uses recursive key sorting plus JSON.stringify, not RFC 8785; rejects malformed Unicode and oversized records without partial batches. No transmission, endpoint-limit verification, compression or token accounting.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-batch-encode.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Encode exact byte-limited JSON array or NDJSON request payload batches",
            "Pack JSON records into contiguous UTF-8-sized bodies without splitting records",
            "Measure escaped JSON framing and hash unchanged batch wire bytes"
          ],
          "whenToUse": [
            "Encode exact byte-limited JSON array or NDJSON request payload batches",
            "Pack JSON records into contiguous UTF-8-sized bodies without splitting records",
            "Measure escaped JSON framing and hash unchanged batch wire bytes"
          ],
          "whenNotToUse": [
            "Sending requests, validating target endpoint schemas or actual server limits, sizing headers, HTTP framing, compression or tokenization",
            "Arbitrary-precision JSON numbers or RFC 8785 cryptographic canonicalization",
            "Fetching data, executing caller code, contacting agents, transmitting a payload, or changing remote state",
            "Verifying semantic truth, source authenticity, identity, permissions, or business relationships"
          ],
          "capabilities": [
            "Actual body UTF-8 byte counts, not the result wrapper representation",
            "Greedy contiguous record-preserving batches with hard item and byte caps",
            "Recursive sorted-key JSON.stringify profile; array order retained and final LF required for NDJSON",
            "Single oversized record rejects all output; optional SHA-256 hashes exact body bytes",
            "Networkless deterministic transforms; externalRequests=0; semanticValidityVerified=false"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "maxRecords": 500,
            "maxUtf8Bytes": 100000,
            "maxItemsPerBatch": 500,
            "maxBatches": 500,
            "serialization": "recursive sorted-key JSON.stringify; integer-index keys first numerically",
            "ndjsonFinalLf": "always on nonempty batches"
          },
          "related": [
            "json-canonicalize",
            "ndjson-inspect",
            "message-batch-plan"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "RECORD_TOO_LARGE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "$ref": "#/paths/~1v1~1mpp~1json-batch-encode/post/requestBody/content/application~1json/schema/$defs/__schema0"
                    }
                  },
                  "framing": {
                    "type": "string",
                    "enum": [
                      "json-array",
                      "ndjson-lf"
                    ]
                  },
                  "maxUtf8Bytes": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100000
                  },
                  "maxItemsPerBatch": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 500
                  },
                  "includeSha256": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "records",
                  "framing",
                  "maxUtf8Bytes",
                  "maxItemsPerBatch"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-batch-encode/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-batch-encode/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "x": "é"
                  },
                  {
                    "x": "a"
                  },
                  {
                    "x": "😀"
                  }
                ],
                "framing": "json-array",
                "maxUtf8Bytes": 23,
                "maxItemsPerBatch": 100,
                "includeSha256": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-batch-encode",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "sorted-json-utf8-batches-v1"
                        },
                        "framing": {
                          "type": "string",
                          "enum": [
                            "json-array",
                            "ndjson-lf"
                          ]
                        },
                        "batches": {
                          "maxItems": 500,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "itemIndexes": {
                                "minItems": 1,
                                "maxItems": 500,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 499
                                }
                              },
                              "bodyText": {
                                "type": "string",
                                "maxLength": 100000
                              },
                              "utf8Bytes": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100000
                              },
                              "sha256": {
                                "type": "string",
                                "pattern": "^[0-9a-f]{64}$"
                              }
                            },
                            "required": [
                              "itemIndexes",
                              "bodyText",
                              "utf8Bytes"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "itemCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "batchCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "totalUtf8Bytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "semanticValidityVerified": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "framing",
                        "batches",
                        "itemCount",
                        "batchCount",
                        "totalUtf8Bytes",
                        "externalRequests",
                        "semanticValidityVerified"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-batch-encode",
                  "version": "0.29.0",
                  "result": {
                    "profile": "sorted-json-utf8-batches-v1",
                    "framing": "json-array",
                    "batches": [
                      {
                        "itemIndexes": [
                          0,
                          1
                        ],
                        "bodyText": "[{\"x\":\"é\"},{\"x\":\"a\"}]",
                        "utf8Bytes": 22,
                        "sha256": "2806c29934df94f04cf761490e60e34550c4b905e5bce434c874377c74d5bd1f"
                      },
                      {
                        "itemIndexes": [
                          2
                        ],
                        "bodyText": "[{\"x\":\"😀\"}]",
                        "utf8Bytes": 14,
                        "sha256": "62ec360b21da91f071c8ce7a2866d45c424c8f162eecb1dc504d8b32de7a0cc7"
                      }
                    ],
                    "itemCount": 3,
                    "batchCount": 2,
                    "totalUtf8Bytes": 36,
                    "externalRequests": 0,
                    "semanticValidityVerified": false
                  },
                  "provenance": {
                    "inputSha256": "d9cc3efaf7a499898a72fd490b169cb52507707b5cd1a1651b4dd9d21a06139d",
                    "outputSha256": "aef8b58f28ceab34c9424ba2b58eeecb3b82d2d92d1319868c84336f3aceaedd",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/integer-apportion": {
      "post": {
        "operationId": "mpp_integer_apportion",
        "summary": "Apportion exact integer units",
        "description": "Allocate a declared integer total among exact nonnegative decimal weights using floors and largest remainders. Conserves units with exact quota evidence and ID tie breaks; no minima, caps, fairness certification, payments or monotonicity guarantee.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/integer-apportion.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Divide a fixed total of indivisible units among weighted categories",
            "Produce integer weighted allocations whose sum equals the declared total"
          ],
          "whenToUse": [
            "Divide a fixed total of indivisible units among weighted categories",
            "Produce integer weighted allocations whose sum equals the declared total"
          ],
          "whenNotToUse": [
            "Fairness certification, eligibility decisions about people, payments, or resource reservations",
            "Monotonic allocation as total changes, recipient minimums or maximums",
            "Live execution, network lookups, payments, reservation, or inferring factual correctness of supplied data"
          ],
          "capabilities": [
            "largest-remainder-v1 profile; exact BigInt decimal scaling and reduced quota/remainder fractions",
            "Largest fractional remainder first; ties and output order use exact UTF-16 ID ordering independent of input order",
            "Networkless supplied-input computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "recipients": 128,
            "totalIntegerDigits": 24,
            "weightIntegerDigits": 24,
            "weightFractionDigits": 18
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "ZERO_WEIGHT_TOTAL"
          ],
          "related": [
            "rubric-score-aggregate",
            "numeric-rounding-check"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "totalUnits": {
                    "type": "string",
                    "maxLength": 24,
                    "pattern": "^(?:0|[1-9]\\d{0,23})$",
                    "description": "Canonical nonnegative integer string, at most 24 digits"
                  },
                  "recipients": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "weight": {
                          "type": "string",
                          "maxLength": 43,
                          "pattern": "^(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$",
                          "description": "Nonnegative exact decimal string; 24 integer and 18 fraction digits; at least one weight positive"
                        }
                      },
                      "required": [
                        "id",
                        "weight"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "totalUnits",
                  "recipients"
                ],
                "additionalProperties": false
              },
              "example": {
                "totalUnits": "7",
                "recipients": [
                  {
                    "id": "a",
                    "weight": "5"
                  },
                  {
                    "id": "b",
                    "weight": "3"
                  },
                  {
                    "id": "c",
                    "weight": "2"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "integer-apportion",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "largest-remainder-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "totalUnits": {
                          "type": "string",
                          "maxLength": 100,
                          "pattern": "^(?:0|[1-9]\\d*)$"
                        },
                        "allocatedTotal": {
                          "type": "string",
                          "maxLength": 100,
                          "pattern": "^(?:0|[1-9]\\d*)$"
                        },
                        "remainderUnits": {
                          "type": "string",
                          "const": "0"
                        },
                        "allocations": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "units": {
                                "type": "string",
                                "maxLength": 100,
                                "pattern": "^(?:0|[1-9]\\d*)$"
                              },
                              "floor": {
                                "type": "string",
                                "maxLength": 100,
                                "pattern": "^(?:0|[1-9]\\d*)$"
                              },
                              "extraUnit": {
                                "type": "boolean"
                              },
                              "quota": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 100,
                                    "pattern": "^(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 100,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "remainder": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 100,
                                    "pattern": "^(?:0|[1-9]\\d*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 100,
                                    "pattern": "^[1-9]\\d*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "id",
                              "units",
                              "floor",
                              "extraUnit",
                              "quota",
                              "remainder"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "totalUnits",
                        "allocatedTotal",
                        "remainderUnits",
                        "allocations"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "integer-apportion",
                  "version": "0.29.0",
                  "result": {
                    "profile": "largest-remainder-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "totalUnits": "7",
                    "allocatedTotal": "7",
                    "remainderUnits": "0",
                    "allocations": [
                      {
                        "id": "a",
                        "units": "4",
                        "floor": "3",
                        "extraUnit": true,
                        "quota": {
                          "numerator": "7",
                          "denominator": "2"
                        },
                        "remainder": {
                          "numerator": "1",
                          "denominator": "2"
                        }
                      },
                      {
                        "id": "b",
                        "units": "2",
                        "floor": "2",
                        "extraUnit": false,
                        "quota": {
                          "numerator": "21",
                          "denominator": "10"
                        },
                        "remainder": {
                          "numerator": "1",
                          "denominator": "10"
                        }
                      },
                      {
                        "id": "c",
                        "units": "1",
                        "floor": "1",
                        "extraUnit": false,
                        "quota": {
                          "numerator": "7",
                          "denominator": "5"
                        },
                        "remainder": {
                          "numerator": "2",
                          "denominator": "5"
                        }
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "9ddf2d69428662c833132d77986f8ca47250684ac4bca2b93c84eddcabf5afc5",
                    "outputSha256": "e58555a1109461b1bc3bfc820c78fbcb5225f855ca34d39e5d9c465cce4f1aaa",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/business-calendar-shift": {
      "post": {
        "operationId": "mpp_business_calendar_shift",
        "summary": "Shift explicit business dates",
        "description": "Shift date-only Gregorian values by working days under supplied weekly closures and explicit closed dates. Roll an initially closed anchor explicitly, then count open dates strictly after or before it. No holiday lookup, clock, timezone or legal deadline verification.",
        "tags": [
          "standards"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/business-calendar-shift.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Add or subtract business days on an explicit supplied closure calendar",
            "Roll a closed starting date before a date-only working-day offset"
          ],
          "whenToUse": [
            "Add or subtract business days on an explicit supplied closure calendar",
            "Roll a closed starting date before a date-only working-day offset"
          ],
          "whenNotToUse": [
            "National holiday discovery, bank settlement or legal deadline advice",
            "Working-hour arithmetic, timezone conversion, recurring event scheduling or real organization calendar verification",
            "Live execution, network lookups, payments, reservation, or inferring factual correctness of supplied data"
          ],
          "capabilities": [
            "explicit-business-calendar-v1; Gregorian years 1900–2199 and Monday=1 through Sunday=7",
            "First roll anchor; offset zero returns anchor; calendarDays is signed result minus original start",
            "Atomic call: any invalid date, closed error anchor, range or traversal failure withholds all results",
            "Skipped evidence is in traversal order and includes rolled closed anchors; repeated visits are counted; first 100 retained per item",
            "Networkless supplied-input computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "items": 128,
            "closedDates": 500,
            "workingDays": "-366..366",
            "minYear": 1900,
            "maxYear": 2199,
            "itemDateVisits": 10000,
            "totalDateVisits": 100000,
            "skippedEvidencePerItem": 100
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "INVALID_DATE",
            "INVALID_CALENDAR",
            "CLOSED_START",
            "DATE_RANGE_EXHAUSTED",
            "TRAVERSAL_LIMIT"
          ],
          "related": [
            "timestamp-convert",
            "duration-convert",
            "timezone-convert"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "calendar": {
                    "type": "object",
                    "properties": {
                      "closedWeekdays": {
                        "maxItems": 7,
                        "type": "array",
                        "items": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 7
                        },
                        "description": "Monday=1 through Sunday=7; duplicate weekdays rejected; at least one weekday must stay open"
                      },
                      "closedDates": {
                        "maxItems": 500,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "minLength": 10,
                          "maxLength": 10,
                          "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                          "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                        },
                        "description": "Explicit closures only; duplicates are collapsed"
                      }
                    },
                    "required": [
                      "closedWeekdays",
                      "closedDates"
                    ],
                    "additionalProperties": false
                  },
                  "items": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "start": {
                          "type": "string",
                          "minLength": 10,
                          "maxLength": 10,
                          "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                          "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                        },
                        "workingDays": {
                          "type": "integer",
                          "minimum": -366,
                          "maximum": 366
                        },
                        "roll": {
                          "type": "string",
                          "enum": [
                            "error",
                            "following",
                            "preceding"
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "start",
                        "workingDays",
                        "roll"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "calendar",
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "calendar": {
                  "closedWeekdays": [
                    6,
                    7
                  ],
                  "closedDates": [
                    "2026-10-05"
                  ]
                },
                "items": [
                  {
                    "id": "review",
                    "start": "2026-10-02",
                    "workingDays": 1,
                    "roll": "error"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "business-calendar-shift",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "explicit-business-calendar-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "calendarVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "visitedDates": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "items": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "start": {
                                "type": "string",
                                "minLength": 10,
                                "maxLength": 10,
                                "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                                "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                              },
                              "anchor": {
                                "type": "string",
                                "minLength": 10,
                                "maxLength": 10,
                                "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                                "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                              },
                              "date": {
                                "type": "string",
                                "minLength": 10,
                                "maxLength": 10,
                                "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                                "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                              },
                              "workingDays": {
                                "type": "integer",
                                "minimum": -366,
                                "maximum": 366
                              },
                              "calendarDays": {
                                "type": "integer",
                                "minimum": -109572,
                                "maximum": 109572
                              },
                              "rolledCalendarDays": {
                                "type": "integer",
                                "minimum": -109572,
                                "maximum": 109572
                              },
                              "visitedDates": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "skippedDates": {
                                "maxItems": 100,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 10,
                                  "maxLength": 10,
                                  "pattern": "^(?:19|20|21)\\d\\d-\\d\\d-\\d\\d$",
                                  "description": "Real Gregorian YYYY-MM-DD date, 1900-01-01 through 2199-12-31; no timezone or clock"
                                }
                              },
                              "skippedDateCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "omittedSkippedDates": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "skippedDatesTruncated": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "id",
                              "start",
                              "anchor",
                              "date",
                              "workingDays",
                              "calendarDays",
                              "rolledCalendarDays",
                              "visitedDates",
                              "skippedDates",
                              "skippedDateCount",
                              "omittedSkippedDates",
                              "skippedDatesTruncated"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "calendarVerified",
                        "visitedDates",
                        "items"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "business-calendar-shift",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-business-calendar-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "calendarVerified": false,
                    "visitedDates": 5,
                    "items": [
                      {
                        "id": "review",
                        "start": "2026-10-02",
                        "anchor": "2026-10-02",
                        "date": "2026-10-06",
                        "workingDays": 1,
                        "calendarDays": 4,
                        "rolledCalendarDays": 0,
                        "visitedDates": 5,
                        "skippedDates": [
                          "2026-10-03",
                          "2026-10-04",
                          "2026-10-05"
                        ],
                        "skippedDateCount": 3,
                        "omittedSkippedDates": 0,
                        "skippedDatesTruncated": false
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "b59e754638f0b033f77a1cf5d45d473561821694b365b24d7bfdfc536f9f9ac8",
                    "outputSha256": "52a3d3006c0778b8d94a4ca5ccc726ae86341723fc1c029d21eab5f40975d43e",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/localization-bundle-build": {
      "post": {
        "operationId": "mpp_localization_bundle_build",
        "summary": "Build literal localization bundles",
        "description": "Produce an atomic source-ordered localization bundle after exact key coverage and repeated {{name}} placeholder checks. Explicit source fallback provenance; malformed double braces or mismatches block the bundle. No translation, language verification, rendering or escaping.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/localization-bundle-build.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Build a source-ordered target localization dictionary with explicit fallback provenance",
            "Check literal translated placeholder names and repeated counts before releasing a bundle"
          ],
          "whenToUse": [
            "Build a source-ordered target localization dictionary with explicit fallback provenance",
            "Check literal translated placeholder names and repeated counts before releasing a bundle"
          ],
          "whenNotToUse": [
            "Generate or evaluate translations, detect language or verify semantic quality",
            "ICU/MessageFormat plural rules, printf, HTML/Markdown interpretation, sanitization or locale fallback chains",
            "Live execution, network lookups, payments, reservation, or inferring factual correctness of supplied data"
          ],
          "capabilities": [
            "double-brace-literal-v1 requires ASCII [A-Za-z_][A-Za-z0-9_.-]{0,63} names; reserved __proto__/constructor/prototype names block; single braces are literal",
            "Placeholder multisets must match including repeats; order may differ; texts remain unchanged",
            "Duplicate/unknown/missing keys, malformed double braces or mismatch yield blocked with bundle:null; no partially validated bundle",
            "Missing mode is required: error or source-fallback; output entries follow source input order",
            "Networkless supplied-input computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "findings": 200,
            "sourceEntries": 1000,
            "targetEntries": 1000,
            "entryTextCodeUnits": 10000,
            "totalTextCodeUnits": 60000,
            "placeholderNameCodeUnits": 64
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "TEXT_LIMIT"
          ],
          "related": [
            "template-render",
            "records-project"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "format": {
                    "type": "string",
                    "const": "double-brace-literal-v1"
                  },
                  "missing": {
                    "type": "string",
                    "enum": [
                      "error",
                      "source-fallback"
                    ]
                  },
                  "source": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 10000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "target": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 10000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "format",
                  "missing",
                  "source",
                  "target"
                ],
                "additionalProperties": false
              },
              "example": {
                "format": "double-brace-literal-v1",
                "missing": "source-fallback",
                "source": [
                  {
                    "id": "welcome",
                    "text": "Hello, {{name}}!"
                  },
                  {
                    "id": "save",
                    "text": "Save"
                  }
                ],
                "target": [
                  {
                    "id": "welcome",
                    "text": "Hola, {{name}}!"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "localization-bundle-build",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "double-brace-literal-v1"
                        },
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "translationVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "escaped": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "ready",
                            "ready-with-fallbacks",
                            "blocked"
                          ]
                        },
                        "bundle": {
                          "anyOf": [
                            {
                              "maxItems": 1000,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "text": {
                                    "type": "string",
                                    "maxLength": 10000
                                  },
                                  "origin": {
                                    "type": "string",
                                    "enum": [
                                      "target",
                                      "source-fallback"
                                    ]
                                  },
                                  "placeholders": {
                                    "maxItems": 2000,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "name": {
                                          "type": "string",
                                          "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,63}$"
                                        },
                                        "count": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 9007199254740991
                                        }
                                      },
                                      "required": [
                                        "name",
                                        "count"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "id",
                                  "text",
                                  "origin",
                                  "placeholders"
                                ],
                                "additionalProperties": false
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "sourceCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "targetCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "translatedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "fallbackCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "fallbackIds": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "findings": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "string"
                              },
                              "path": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              },
                              "placeholder": {
                                "type": "string"
                              },
                              "sourceCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "targetCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              }
                            },
                            "required": [
                              "code",
                              "path",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "findingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "truncated": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "profile",
                        "advisoryOnly",
                        "externalRequests",
                        "translationVerified",
                        "escaped",
                        "status",
                        "bundle",
                        "sourceCount",
                        "targetCount",
                        "translatedCount",
                        "fallbackCount",
                        "fallbackIds",
                        "findings",
                        "findingCount",
                        "truncated"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "localization-bundle-build",
                  "version": "0.29.0",
                  "result": {
                    "profile": "double-brace-literal-v1",
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "translationVerified": false,
                    "escaped": false,
                    "status": "ready-with-fallbacks",
                    "bundle": [
                      {
                        "id": "welcome",
                        "text": "Hola, {{name}}!",
                        "origin": "target",
                        "placeholders": [
                          {
                            "name": "name",
                            "count": 1
                          }
                        ]
                      },
                      {
                        "id": "save",
                        "text": "Save",
                        "origin": "source-fallback",
                        "placeholders": []
                      }
                    ],
                    "sourceCount": 2,
                    "targetCount": 1,
                    "translatedCount": 1,
                    "fallbackCount": 1,
                    "fallbackIds": [
                      "save"
                    ],
                    "findings": [],
                    "findingCount": 0,
                    "truncated": false
                  },
                  "provenance": {
                    "inputSha256": "635f16fce938905c7e4bdb383eeb07bf6a272f963164242617e3913e38ddab38",
                    "outputSha256": "9bfff22dfcf38e181c31122c7df3812a6f33b8d9a49c897ae0a17d172899b15b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/workflow-resource-plan": {
      "post": {
        "operationId": "mpp_workflow_resource_plan",
        "summary": "Renewable Resource Workflow Planner",
        "description": "Build a deterministic capacity-feasible candidate task schedule with dependencies, release times and renewable resource demands; no optimality or live availability guarantee.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/workflow-resource-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Schedule dependent tasks against supplied concurrent worker or renewable resource capacities",
            "Return earliest-insertion candidate start and end times when unlimited-worker DAG timing is insufficient"
          ],
          "whenToUse": [
            "Schedule dependent tasks against supplied concurrent worker or renewable resource capacities",
            "Return earliest-insertion candidate start and end times when unlimited-worker DAG timing is insufficient"
          ],
          "whenNotToUse": [
            "Optimal makespan, execution, resource reservations, observed worker availability or runtime prediction",
            "Token-bucket dispatch quotas or retry timing",
            "Proof that no schedule can fit a caller horizon"
          ],
          "capabilities": [
            "Nonpreemptive serial schedule generation; ready-task order is priority descending then exact UTF-16 ID ascending",
            "Earliest feasible integer insertion; half-open execution intervals; prior placements never move",
            "Complete resource-usage evidence and complete candidate even when the reporting horizon is exceeded",
            "All input durations, capacities and availability are assumptions; no external requests or execution"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "tasks": 64,
            "resources": 8,
            "dependencyEdges": 256,
            "resourceUnits": 1000000000,
            "duration": 1000000000,
            "release": 1000000000000,
            "scheduleTime": 1064000000000,
            "usageSegments": 128,
            "buckets": 8,
            "jobs": 200,
            "tokenUnits": 1000000000,
            "refillPeriodMs": 1000000000,
            "horizonMs": 1000000000000
          },
          "related": [
            "workflow-dag-analyze",
            "quota-dispatch-plan"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "EDGE_LIMIT",
            "DUPLICATE_DEPENDENCY",
            "MISSING_DEPENDENCY",
            "UNKNOWN_RESOURCE",
            "DEMAND_EXCEEDS_CAPACITY",
            "DEPENDENCY_CYCLE",
            "TIME_LIMIT",
            "INTERNAL_PLANNING_ERROR"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "resources": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "additionalProperties": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 1000000000
                    }
                  },
                  "tasks": {
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "duration": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000000
                        },
                        "release": {
                          "default": 0,
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000000
                        },
                        "priority": {
                          "default": 0,
                          "type": "integer",
                          "minimum": -1000000000,
                          "maximum": 1000000000
                        },
                        "requires": {
                          "default": {},
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "additionalProperties": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 1000000000
                          }
                        },
                        "dependsOn": {
                          "default": [],
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        }
                      },
                      "required": [
                        "id",
                        "duration"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "horizon": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1064000000000
                  }
                },
                "required": [
                  "resources",
                  "tasks"
                ],
                "additionalProperties": false
              },
              "example": {
                "resources": {
                  "cpu": 2,
                  "browser": 1
                },
                "tasks": [
                  {
                    "id": "a",
                    "duration": 5,
                    "requires": {
                      "cpu": 1,
                      "browser": 1
                    },
                    "dependsOn": []
                  },
                  {
                    "id": "b",
                    "duration": 3,
                    "requires": {
                      "cpu": 1,
                      "browser": 1
                    },
                    "dependsOn": []
                  },
                  {
                    "id": "c",
                    "duration": 4,
                    "requires": {
                      "cpu": 2
                    },
                    "dependsOn": [
                      "a"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "workflow-resource-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "availabilityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "scheduled",
                            "horizon-exceeded"
                          ]
                        },
                        "tasks": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1064000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1064000000000
                              }
                            },
                            "required": [
                              "id",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "selectionOrder": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "makespan": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1064000000000
                        },
                        "horizon": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1064000000000
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "withinHorizon": {
                          "type": [
                            "boolean",
                            "null"
                          ]
                        },
                        "optimalityGuaranteed": {
                          "type": "boolean",
                          "const": false
                        },
                        "resourceUsage": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1064000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1064000000000
                              },
                              "usage": {
                                "type": "object",
                                "propertyNames": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 100
                                },
                                "additionalProperties": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 1000000000
                                }
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "usage"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "advisoryOnly",
                        "externalRequests",
                        "execution",
                        "availabilityVerified",
                        "status",
                        "tasks",
                        "selectionOrder",
                        "makespan",
                        "horizon",
                        "withinHorizon",
                        "optimalityGuaranteed",
                        "resourceUsage"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "workflow-resource-plan",
                  "version": "0.29.0",
                  "result": {
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "execution": false,
                    "availabilityVerified": false,
                    "status": "scheduled",
                    "tasks": [
                      {
                        "id": "a",
                        "start": 0,
                        "end": 5
                      },
                      {
                        "id": "b",
                        "start": 5,
                        "end": 8
                      },
                      {
                        "id": "c",
                        "start": 8,
                        "end": 12
                      }
                    ],
                    "selectionOrder": [
                      "a",
                      "b",
                      "c"
                    ],
                    "makespan": 12,
                    "horizon": null,
                    "withinHorizon": null,
                    "optimalityGuaranteed": false,
                    "resourceUsage": [
                      {
                        "start": 0,
                        "end": 8,
                        "usage": {
                          "browser": 1,
                          "cpu": 1
                        }
                      },
                      {
                        "start": 8,
                        "end": 12,
                        "usage": {
                          "browser": 0,
                          "cpu": 2
                        }
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "d1150812127c26832befbe825634dd56b8e2ccfb0db8042878f7c054d8dd2361",
                    "outputSha256": "29c03bb47adc67b5c6c79c353333f2d3a6cbc8fed59059f5721ecc702014135c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/quota-dispatch-plan": {
      "post": {
        "operationId": "mpp_quota_dispatch_plan",
        "summary": "FIFO Token Bucket Dispatch Planner",
        "description": "Plan FIFO not-before times from supplied continuous-refill token buckets, with exact rational balance evidence and an explicitly partial horizon prefix; no requests are sent.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/quota-dispatch-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Plan FIFO API job dispatch against supplied token bucket capacity and refill assumptions",
            "Return exact not-before millisecond times and rational before/after quota balances"
          ],
          "whenToUse": [
            "Plan FIFO API job dispatch against supplied token bucket capacity and refill assumptions",
            "Return exact not-before millisecond times and rational before/after quota balances"
          ],
          "whenNotToUse": [
            "Live quota discovery, provider conformance, request sending, retry permission or guaranteed server acceptance",
            "Persistent quota reservations or synchronization across workers",
            "Renewable resources held for execution durations or optimal job reordering"
          ],
          "capabilities": [
            "Strict token buckets; continuous capped refill; exact BigInt scaled balances and ceiling waits",
            "Supplied FIFO order, head-of-line waiting, simultaneous integer-millisecond dispatch and atomic costs",
            "Horizon-limited prefix is explicitly partial; zero-refill exhaustion withholds every dispatch",
            "All balances are hypothetical; final state is at the last returned dispatch, or time zero for an empty prefix"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "tasks": 64,
            "resources": 8,
            "dependencyEdges": 256,
            "resourceUnits": 1000000000,
            "duration": 1000000000,
            "release": 1000000000000,
            "scheduleTime": 1064000000000,
            "usageSegments": 128,
            "buckets": 8,
            "jobs": 200,
            "tokenUnits": 1000000000,
            "refillPeriodMs": 1000000000,
            "horizonMs": 1000000000000
          },
          "related": [
            "retry-schedule-plan",
            "workflow-resource-plan"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "INVALID_INITIAL_BALANCE",
            "UNKNOWN_BUCKET",
            "IMPOSSIBLE_COST"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "horizonMs": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000000000
                  },
                  "buckets": {
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "capacity": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000000
                        },
                        "initialTokens": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000
                        },
                        "refillTokens": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000
                        },
                        "refillPeriodMs": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000000
                        }
                      },
                      "required": [
                        "id",
                        "capacity",
                        "initialTokens",
                        "refillTokens",
                        "refillPeriodMs"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "jobs": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "releaseMs": {
                          "default": 0,
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000000
                        },
                        "costs": {
                          "default": {},
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "additionalProperties": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 1000000000
                          }
                        }
                      },
                      "required": [
                        "id"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "horizonMs",
                  "buckets",
                  "jobs"
                ],
                "additionalProperties": false
              },
              "example": {
                "horizonMs": 5000,
                "buckets": [
                  {
                    "id": "api",
                    "capacity": 4,
                    "initialTokens": 4,
                    "refillTokens": 1,
                    "refillPeriodMs": 1000
                  }
                ],
                "jobs": [
                  {
                    "id": "a",
                    "releaseMs": 0,
                    "costs": {
                      "api": 3
                    }
                  },
                  {
                    "id": "b",
                    "releaseMs": 0,
                    "costs": {
                      "api": 3
                    }
                  },
                  {
                    "id": "c",
                    "releaseMs": 0,
                    "costs": {
                      "api": 1
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "quota-dispatch-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "availabilityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "planned",
                            "partial",
                            "blocked"
                          ]
                        },
                        "horizonMs": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000000
                        },
                        "jobs": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "notBeforeMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "buckets": {
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    "before": {
                                      "type": "object",
                                      "properties": {
                                        "numerator": {
                                          "type": "string",
                                          "maxLength": 19,
                                          "pattern": "^(?:0|[1-9]\\d*)$"
                                        },
                                        "denominator": {
                                          "type": "string",
                                          "maxLength": 10,
                                          "pattern": "^[1-9]\\d*$"
                                        }
                                      },
                                      "required": [
                                        "numerator",
                                        "denominator"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "after": {
                                      "type": "object",
                                      "properties": {
                                        "numerator": {
                                          "type": "string",
                                          "maxLength": 19,
                                          "pattern": "^(?:0|[1-9]\\d*)$"
                                        },
                                        "denominator": {
                                          "type": "string",
                                          "maxLength": 10,
                                          "pattern": "^[1-9]\\d*$"
                                        }
                                      },
                                      "required": [
                                        "numerator",
                                        "denominator"
                                      ],
                                      "additionalProperties": false
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "before",
                                    "after"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "id",
                              "notBeforeMs",
                              "buckets"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "unplannedIds": {
                          "maxItems": 200,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          }
                        },
                        "nextNotBeforeMs": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 19,
                              "pattern": "^(?:0|[1-9]\\d*)$"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "blockedJobId": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "blockedReason": {
                          "anyOf": [
                            {
                              "type": "string",
                              "const": "zero-refill-exhausted"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "finalState": {
                          "type": "object",
                          "properties": {
                            "atMs": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1000000000000
                            },
                            "buckets": {
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "tokens": {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 19,
                                        "pattern": "^(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 10,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "required": [
                                  "id",
                                  "tokens"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "atMs",
                            "buckets"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "advisoryOnly",
                        "externalRequests",
                        "execution",
                        "availabilityVerified",
                        "status",
                        "horizonMs",
                        "jobs",
                        "unplannedIds",
                        "nextNotBeforeMs",
                        "blockedJobId",
                        "blockedReason",
                        "finalState"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "quota-dispatch-plan",
                  "version": "0.29.0",
                  "result": {
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "execution": false,
                    "availabilityVerified": false,
                    "status": "planned",
                    "horizonMs": 5000,
                    "jobs": [
                      {
                        "id": "a",
                        "notBeforeMs": 0,
                        "buckets": [
                          {
                            "id": "api",
                            "before": {
                              "numerator": "4",
                              "denominator": "1"
                            },
                            "after": {
                              "numerator": "1",
                              "denominator": "1"
                            }
                          }
                        ]
                      },
                      {
                        "id": "b",
                        "notBeforeMs": 2000,
                        "buckets": [
                          {
                            "id": "api",
                            "before": {
                              "numerator": "3",
                              "denominator": "1"
                            },
                            "after": {
                              "numerator": "0",
                              "denominator": "1"
                            }
                          }
                        ]
                      },
                      {
                        "id": "c",
                        "notBeforeMs": 3000,
                        "buckets": [
                          {
                            "id": "api",
                            "before": {
                              "numerator": "1",
                              "denominator": "1"
                            },
                            "after": {
                              "numerator": "0",
                              "denominator": "1"
                            }
                          }
                        ]
                      }
                    ],
                    "unplannedIds": [],
                    "nextNotBeforeMs": null,
                    "blockedJobId": null,
                    "blockedReason": null,
                    "finalState": {
                      "atMs": 3000,
                      "buckets": [
                        {
                          "id": "api",
                          "tokens": {
                            "numerator": "0",
                            "denominator": "1"
                          }
                        }
                      ]
                    }
                  },
                  "provenance": {
                    "inputSha256": "38b1cb2bd534f97f7e12eaaedc096de9e2f396892167f446d070db83ef6e6a9a",
                    "outputSha256": "e31439c612a93e1f88c98ad92992588a1e636b8ec4122bd8f3245d61086b264b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/jsonc-values-rewrite": {
      "post": {
        "operationId": "mpp_jsonc_values_rewrite",
        "summary": "Guarded JSONC scalar rewriter",
        "description": "WHEN TO USE: Rewrite existing supplied JSONC scalar values by guarded RFC 6901 pointers while preserving every source character outside the selected value tokens. Strict object-root JSON plus comments and explicit trailing-comma mode; duplicate decoded keys, malformed untouched regions and unsafe integer-valued numbers fail atomically. No general JSON5, structural edits, configuration security checks or filesystem writes.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/jsonc-values-rewrite.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Change guarded scalar configuration values while preserving JSONC comments and untouched formatting",
            "Resolve scalar JSON pointers to source spans before an exact configuration edit"
          ],
          "whenToUse": [
            "Change guarded scalar configuration values while preserving JSONC comments and untouched formatting",
            "Resolve scalar JSON pointers to source spans before an exact configuration edit"
          ],
          "whenNotToUse": [
            "JSON5 syntax, root arrays, duplicate object names, unsafe integers, scalar type changes, insertions, deletions or structure changes",
            "General formatting, schema validation, semantic config safety, arbitrary-precision decimal preservation or file writes",
            "Uploading, executing artifacts, contacting agents or registries, publishing, or changing remote state",
            "Verifying semantic truth, source authenticity, permissions, target API acceptance or signatures"
          ],
          "capabilities": [
            "Profile jsonc-guarded-scalars-v1; entire source parses without recovery",
            "Original-document guards, unique paths and atomic same-type scalar edits",
            "Untouched source characters and scalar spellings preserved; appliedPaths ordered by source position",
            "Result reparsed and compared to an independently constructed intended document; numeric equality identifies negative zero with zero",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "jsonc-guarded-scalars-v1",
            "sourceBytes": 60000,
            "syntaxNodes": 5000,
            "parsedDepth": 20,
            "rewrites": 100,
            "pointerUnits": 512,
            "resultTextBytes": 100000,
            "syntaxNodeCounting": "all JSON values plus member-name tokens; root depth zero",
            "lineCommentEnd": "CR, LF or EOF"
          },
          "related": [
            "text-edits-apply",
            "json-patch",
            "json-schema-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "SOURCE_LIMIT",
            "JSONC_SYNTAX",
            "JSONC_ROOT",
            "JSONC_COMPLEXITY",
            "UNSAFE_NUMBER",
            "DUPLICATE_KEY",
            "INVALID_POINTER",
            "DUPLICATE_PATH",
            "MISSING_PATH",
            "NONSCALAR_TARGET",
            "EXPECTED_MISMATCH",
            "SCALAR_TYPE_CHANGE",
            "RESULT_TEXT_LIMIT",
            "REWRITE_VERIFICATION"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 60000
                  },
                  "allowTrailingComma": {
                    "type": "boolean"
                  },
                  "rewrites": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "maxLength": 512
                        },
                        "expected": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 60000
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "value": {
                          "anyOf": [
                            {
                              "type": "string",
                              "maxLength": 60000
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "path",
                        "expected",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "text",
                  "allowTrailingComma",
                  "rewrites"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "{\n  // retry budget\n  \"retries\": 2,\n  \"label\": \"prod\",\n}\n",
                "allowTrailingComma": true,
                "rewrites": [
                  {
                    "path": "/retries",
                    "expected": 2,
                    "value": 4
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "jsonc-values-rewrite",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "document": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string"
                          },
                          "additionalProperties": {
                            "$ref": "#/paths/~1v1~1mpp~1jsonc-values-rewrite/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                          }
                        },
                        "appliedPaths": {
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 512
                          }
                        }
                      },
                      "required": [
                        "text",
                        "document",
                        "appliedPaths"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1jsonc-values-rewrite/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1jsonc-values-rewrite/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "jsonc-values-rewrite",
                  "version": "0.29.0",
                  "result": {
                    "text": "{\n  // retry budget\n  \"retries\": 4,\n  \"label\": \"prod\",\n}\n",
                    "document": {
                      "retries": 4,
                      "label": "prod"
                    },
                    "appliedPaths": [
                      "/retries"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "8da8ead2632413e3bb0515b55b688399495f46637557e2f0c254ab46ccef7406",
                    "outputSha256": "23597cbeb1977c4dc132cadb81871bbbd8a51f41e141e50511aee04eae4c690d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/multipart-form-encode": {
      "post": {
        "operationId": "mpp_multipart_form_encode",
        "summary": "Exact multipart form body encoder",
        "description": "WHEN TO USE: Construct exact inert multipart/form-data bytes from ordered supplied text or binary file parts, preserving repeated field names. Caller supplies a collision-checked boundary; explicit utf8 or canonical padded Base64 output and decoded wire byte count. Strict ASCII names prevent header injection; no upload, custom headers, nested multipart, automatic field flattening or API acceptance claim.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/multipart-form-encode.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Encode ordered multipart form-data upload bodies with binary files and repeated field names",
            "Measure exact multipart request bytes with deterministic collision-checked boundaries"
          ],
          "whenToUse": [
            "Encode ordered multipart form-data upload bodies with binary files and repeated field names",
            "Measure exact multipart request bytes with deterministic collision-checked boundaries"
          ],
          "whenNotToUse": [
            "Performing HTTP requests or uploads, headers beyond Content-Disposition and Content-Type, nested multipart or endpoint compatibility",
            "Non-ASCII field names or filenames, path filenames, filename*, or implicit charset guessing",
            "Uploading, executing artifacts, contacting agents or registries, publishing, or changing remote state",
            "Verifying semantic truth, source authenticity, permissions, target API acceptance or signatures"
          ],
          "capabilities": [
            "Profile rfc7578-bounded-body-v1; exact CRLF framing and one final closing delimiter",
            "Boundary token rejected anywhere in decoded payload; linear byte scanning",
            "Filename-free fields require text/plain, valid UTF-8 and charset=UTF-8; file media types retain caller casing",
            "Canonical padded standard Base64 with zero padding bits; utf8 output requires valid full-body UTF-8",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "rfc7578-bounded-body-v1",
            "parts": 32,
            "nameBytes": 64,
            "filenameBytes": 128,
            "mediaTypeBytes": 127,
            "boundaryBytes": 60,
            "payloadBytes": 60000,
            "wireBytes": 100000,
            "mediaTypeProfile": "RFC6838 restricted ASCII type/subtype; no parameters"
          },
          "related": [
            "json-batch-encode",
            "base64-convert",
            "content-digest"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "NESTED_MULTIPART",
            "TEXT_MEDIA_TYPE",
            "INVALID_UTF8",
            "BOUNDARY_COLLISION",
            "WIRE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "boundary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 60,
                    "pattern": "^[A-Za-z0-9_-]+$"
                  },
                  "outputEncoding": {
                    "type": "string",
                    "enum": [
                      "utf8",
                      "base64"
                    ]
                  },
                  "parts": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64,
                          "pattern": "^[\\x20-\\x21\\x23-\\x2e\\x30-\\x5b\\x5d-\\x7e]+$"
                        },
                        "filename": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "pattern": "^[\\x20-\\x21\\x23-\\x2e\\x30-\\x5b\\x5d-\\x7e]+$"
                        },
                        "mediaType": {
                          "type": "string",
                          "minLength": 3,
                          "maxLength": 127,
                          "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*\\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*$"
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 80000
                        }
                      },
                      "required": [
                        "name",
                        "mediaType",
                        "encoding",
                        "data"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "boundary",
                  "outputEncoding",
                  "parts"
                ],
                "additionalProperties": false
              },
              "example": {
                "boundary": "b42",
                "outputEncoding": "utf8",
                "parts": [
                  {
                    "name": "file",
                    "filename": "notes.txt",
                    "mediaType": "text/plain",
                    "encoding": "utf8",
                    "data": "abc"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "multipart-form-encode",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "contentType": {
                          "type": "string",
                          "minLength": 31,
                          "maxLength": 100
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "body": {
                          "type": "string",
                          "maxLength": 133336
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100000
                        },
                        "partCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 32
                        }
                      },
                      "required": [
                        "contentType",
                        "encoding",
                        "body",
                        "byteLength",
                        "partCount"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "multipart-form-encode",
                  "version": "0.29.0",
                  "result": {
                    "contentType": "multipart/form-data; boundary=b42",
                    "encoding": "utf8",
                    "body": "--b42\r\nContent-Disposition: form-data; name=\"file\"; filename=\"notes.txt\"\r\nContent-Type: text/plain\r\n\r\nabc\r\n--b42--\r\n",
                    "byteLength": 116,
                    "partCount": 1
                  },
                  "provenance": {
                    "inputSha256": "e22407bb1d5d4451adb5676aab25633a52b61787a22e1f399b608e6643546d39",
                    "outputSha256": "dfa67a8c7d10639911e78caf05010359fbc718ebbbc7a4983d3f907c154ed739",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/oci-artifact-compose": {
      "post": {
        "operationId": "mpp_oci_artifact_compose",
        "summary": "Inline OCI artifact manifest composer",
        "description": "WHEN TO USE: Build a supplied-input OCI 1.1.1 artifact manifest with SHA-256 digests, exact decoded sizes and inline Base64 bytes for every ordered file layer. Caller declares artifactType and media types; fixed empty JSON config and title-only annotations. No enclosing manifest digest, image build, filesystem layout, registry contact, upload, signature or authenticity guarantee.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/oci-artifact-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compose an OCI 1.1.1 artifact manifest from supplied binary or UTF-8 evidence files",
            "Compute content-addressed inline layer descriptors with exact file bytes and source mapping"
          ],
          "whenToUse": [
            "Compose an OCI 1.1.1 artifact manifest from supplied binary or UTF-8 evidence files",
            "Compute content-addressed inline layer descriptors with exact file bytes and source mapping"
          ],
          "whenNotToUse": [
            "OCI image building, registry access, pushing or pulling, tar/layout generation, signatures, provenance truth or publisher authenticity",
            "Enclosing manifest digest without exact serialized bytes, inferred timestamps, executable config, platform or subject",
            "Uploading, executing artifacts, contacting agents or registries, publishing, or changing remote state",
            "Verifying semantic truth, source authenticity, permissions, target API acceptance or signatures"
          ],
          "capabilities": [
            "Profile oci-1.1-inline-artifact-v1; OCI Image Specification 1.1.1 artifact guidance",
            "SHA-256 and size computed from exact decoded file bytes; standard data fields embed canonical Base64",
            "Fixed empty JSON config hashes exact UTF-8 {}; layer order and input-to-layer source map retained",
            "Only standard title annotations; duplicate names rejected, equal bytes under distinct names preserved",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "oci-1.1-inline-artifact-v1",
            "files": 32,
            "nameUnits": 128,
            "mediaTypeBytes": 127,
            "payloadBytes": 60000,
            "manifestBytes": 100000,
            "enclosingManifestDigest": "not returned",
            "mediaTypeProfile": "RFC6838 restricted ASCII type/subtype; no parameters"
          },
          "related": [
            "artifact-manifest-check",
            "content-digest",
            "json-canonicalize"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "INVALID_FILENAME",
            "DUPLICATE_FILENAME",
            "MANIFEST_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "artifactType": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 127,
                    "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*\\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*$"
                  },
                  "files": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "mediaType": {
                          "type": "string",
                          "minLength": 3,
                          "maxLength": 127,
                          "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*\\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*$"
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 80000
                        }
                      },
                      "required": [
                        "name",
                        "mediaType",
                        "encoding",
                        "data"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "artifactType",
                  "files"
                ],
                "additionalProperties": false
              },
              "example": {
                "artifactType": "application/vnd.example.release.v1",
                "files": [
                  {
                    "name": "notes.txt",
                    "mediaType": "text/plain",
                    "encoding": "utf8",
                    "data": "abc"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "oci-artifact-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "manifest": {
                          "type": "object",
                          "properties": {
                            "schemaVersion": {
                              "type": "number",
                              "const": 2
                            },
                            "mediaType": {
                              "type": "string",
                              "const": "application/vnd.oci.image.manifest.v1+json"
                            },
                            "artifactType": {
                              "type": "string",
                              "minLength": 3,
                              "maxLength": 127,
                              "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*\\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*$"
                            },
                            "config": {
                              "type": "object",
                              "properties": {
                                "mediaType": {
                                  "type": "string",
                                  "const": "application/vnd.oci.empty.v1+json"
                                },
                                "digest": {
                                  "type": "string",
                                  "const": "sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a"
                                },
                                "size": {
                                  "type": "number",
                                  "const": 2
                                },
                                "data": {
                                  "type": "string",
                                  "const": "e30="
                                }
                              },
                              "required": [
                                "mediaType",
                                "digest",
                                "size",
                                "data"
                              ],
                              "additionalProperties": false
                            },
                            "layers": {
                              "minItems": 1,
                              "maxItems": 32,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "mediaType": {
                                    "type": "string",
                                    "minLength": 3,
                                    "maxLength": 127,
                                    "pattern": "^[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*\\/[A-Za-z0-9][A-Za-z0-9!#$&^_.+\\-]*$"
                                  },
                                  "digest": {
                                    "type": "string",
                                    "pattern": "^sha256:[a-f0-9]{64}$"
                                  },
                                  "size": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 60000
                                  },
                                  "data": {
                                    "type": "string",
                                    "maxLength": 80000
                                  },
                                  "annotations": {
                                    "type": "object",
                                    "properties": {
                                      "org.opencontainers.image.title": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 128
                                      }
                                    },
                                    "required": [
                                      "org.opencontainers.image.title"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "required": [
                                  "mediaType",
                                  "digest",
                                  "size",
                                  "data",
                                  "annotations"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "schemaVersion",
                            "mediaType",
                            "artifactType",
                            "config",
                            "layers"
                          ],
                          "additionalProperties": false
                        },
                        "sourceMap": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 31
                              },
                              "layerIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 31
                              }
                            },
                            "required": [
                              "inputIndex",
                              "layerIndex"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "manifest",
                        "sourceMap"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "oci-artifact-compose",
                  "version": "0.29.0",
                  "result": {
                    "manifest": {
                      "schemaVersion": 2,
                      "mediaType": "application/vnd.oci.image.manifest.v1+json",
                      "artifactType": "application/vnd.example.release.v1",
                      "config": {
                        "mediaType": "application/vnd.oci.empty.v1+json",
                        "digest": "sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
                        "size": 2,
                        "data": "e30="
                      },
                      "layers": [
                        {
                          "mediaType": "text/plain",
                          "digest": "sha256:ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad",
                          "size": 3,
                          "data": "YWJj",
                          "annotations": {
                            "org.opencontainers.image.title": "notes.txt"
                          }
                        }
                      ]
                    },
                    "sourceMap": [
                      {
                        "inputIndex": 0,
                        "layerIndex": 0
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "3bdff892ccc8769982df4a4d86508659e0fa7b5f8e1e7ec87dea660821348835",
                    "outputSha256": "36a3b667aea34e198c52ff1e2bd46e6ff7a8117d7f9e8b01ad250d831100b91f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/gitignore-path-select": {
      "post": {
        "operationId": "mpp_gitignore_path_select",
        "summary": "Git-ignore Path Selection",
        "description": "Select supplied untracked file paths under a strict root-only ASCII Git-ignore subset with excluded-ancestor and final-rule evidence.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/gitignore-path-select.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Select supplied release files using root Git-ignore rules",
            "Explain excluded ancestors and negated file patterns"
          ],
          "whenToUse": [
            "Select supplied release files using root Git-ignore rules",
            "Explain excluded ancestors and negated file patterns"
          ],
          "whenNotToUse": [
            "Full Git-ignore syntax, bracket classes, escapes, nested ignore files, Git index/tracked state, symlinks, repository discovery or secret detection",
            "Fetching files, reading a repository, executing code or tests, contacting agents, publishing releases, or changing remote state"
          ],
          "capabilities": [
            "Declared profile: gitignore-root-ascii-v1",
            "Last matching root rule with explicit directory evaluation; excluded parents block child re-inclusion",
            "Literal segments, *, ?, supported positional **, root anchors, directory-only patterns and negation",
            "Preserves candidate input order; no matching rule gives null evidence; work-cap failure returns no selection",
            "Deterministic supplied-input-only operation; no network, filesystem, shell or current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "gitignore-root-ascii-v1",
            "paths": 500,
            "activeRules": 128,
            "pathBytes": 256,
            "ruleBytes": 256,
            "pathDepth": 16,
            "inferredNodes": 10000,
            "patternStateTransitions": 5000000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "UNSUPPORTED_PATTERN",
            "INVALID_PATH",
            "DUPLICATE_PATH",
            "PATH_COLLISION"
          ],
          "related": [
            "oci-artifact-compose",
            "multipart-form-encode",
            "artifact-manifest-check"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "paths": {
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 256
                    }
                  },
                  "ignoreText": {
                    "type": "string",
                    "maxLength": 100000
                  }
                },
                "required": [
                  "paths",
                  "ignoreText"
                ],
                "additionalProperties": false
              },
              "example": {
                "paths": [
                  "src/main.ts",
                  "dist/app.js",
                  "notes.txt",
                  "keep.log",
                  "debug.log"
                ],
                "ignoreText": "dist/\n*.log\n!keep.log\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "gitignore-path-select",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "selectedPaths": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "decisions": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "ignored": {
                                "type": "boolean"
                              },
                              "ruleLine": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 1,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "matchedPath": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "ancestorBlocked": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "path",
                              "ignored",
                              "ruleLine",
                              "matchedPath",
                              "ancestorBlocked"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "selectedPaths",
                        "decisions"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "gitignore-path-select",
                  "version": "0.29.0",
                  "result": {
                    "selectedPaths": [
                      "src/main.ts",
                      "notes.txt",
                      "keep.log"
                    ],
                    "decisions": [
                      {
                        "path": "src/main.ts",
                        "ignored": false,
                        "ruleLine": null,
                        "matchedPath": null,
                        "ancestorBlocked": false
                      },
                      {
                        "path": "dist/app.js",
                        "ignored": true,
                        "ruleLine": 1,
                        "matchedPath": "dist",
                        "ancestorBlocked": true
                      },
                      {
                        "path": "notes.txt",
                        "ignored": false,
                        "ruleLine": null,
                        "matchedPath": null,
                        "ancestorBlocked": false
                      },
                      {
                        "path": "keep.log",
                        "ignored": false,
                        "ruleLine": 3,
                        "matchedPath": "keep.log",
                        "ancestorBlocked": false
                      },
                      {
                        "path": "debug.log",
                        "ignored": true,
                        "ruleLine": 2,
                        "matchedPath": "debug.log",
                        "ancestorBlocked": false
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "2e2220da3a7655d6e6fb606e0c4664a5081440814bfa8123f938d50a9284f1f6",
                    "outputSha256": "93ade9695e30afbb175491edc26b0ad710d2a6d3e05c60c28143be8ccd766f68",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/conventional-release-plan": {
      "post": {
        "operationId": "mpp_conventional_release_plan",
        "summary": "Conventional Release Proposal",
        "description": "Propose a stable numeric version and escaped release notes from supplied commits under an explicit bounded Conventional Commit footer grammar and pre-1.0 policy.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/conventional-release-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Create release notes and a version proposal from supplied Conventional Commits",
            "Apply an explicit breaking-change policy before version 1.0"
          ],
          "whenToUse": [
            "Create release notes and a version proposal from supplied Conventional Commits",
            "Apply an explicit breaking-change policy before version 1.0"
          ],
          "whenNotToUse": [
            "Full SemVer/prerelease calculation, all Conventional Commit footer layouts, code-level breaking-change detection, commit-range discovery or revert cancellation",
            "Fetching files, reading a repository, executing code or tests, contacting agents, publishing releases, or changing remote state"
          ],
          "capabilities": [
            "Declared profile: conventional-release-explicit-policy-v1",
            "Case-insensitive type classification; ! and uppercase BREAKING CHANGE/BREAKING-CHANGE colon-space footers",
            "Strict final contiguous footer block with multiline nonblank values; ambiguous layouts fail with sourceIndex",
            "Fix means patch, feat means minor, breaking marker means declared major/pre-1.0 policy; highest effect wins",
            "Deterministic escaped Markdown; no dates, fabricated links, tags, commits, pushes or publishing",
            "Deterministic supplied-input-only operation; no network, filesystem, shell or current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "conventional-release-explicit-policy-v1",
            "commits": 200,
            "messageBytes": 8000,
            "aggregateMessageBytes": 60000,
            "physicalLines": 100,
            "footerEntries": 20,
            "idCharacters": 64,
            "typeScopeCharacters": 64,
            "versionComponent": 1000000000,
            "releaseOutputBytes": 150000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_VERSION",
            "INVALID_COMMIT",
            "INVALID_ID",
            "DUPLICATE_ID",
            "VERSION_OVERFLOW"
          ],
          "related": [
            "semver-evaluate",
            "jsonc-values-rewrite",
            "oci-artifact-compose"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "currentVersion": {
                    "type": "string",
                    "minLength": 5,
                    "maxLength": 32
                  },
                  "preOneBreaking": {
                    "type": "string",
                    "enum": [
                      "major",
                      "minor"
                    ]
                  },
                  "commits": {
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "message": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 8000
                        }
                      },
                      "required": [
                        "id",
                        "message"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "currentVersion",
                  "preOneBreaking",
                  "commits"
                ],
                "additionalProperties": false
              },
              "example": {
                "currentVersion": "1.2.3",
                "preOneBreaking": "major",
                "commits": [
                  {
                    "id": "c1",
                    "message": "feat(api): add CSV export"
                  },
                  {
                    "id": "c2",
                    "message": "fix: reset retry counter"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "conventional-release-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "releaseType": {
                          "type": "string",
                          "enum": [
                            "none",
                            "patch",
                            "minor",
                            "major"
                          ]
                        },
                        "nextVersion": {
                          "type": "string"
                        },
                        "entries": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "sourceIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "type": {
                                "type": "string"
                              },
                              "scope": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "description": {
                                "type": "string"
                              },
                              "breaking": {
                                "type": "boolean"
                              },
                              "releaseEffect": {
                                "type": "string",
                                "enum": [
                                  "none",
                                  "patch",
                                  "minor",
                                  "major"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "sourceIndex",
                              "type",
                              "scope",
                              "description",
                              "breaking",
                              "releaseEffect"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "markdown": {
                          "type": "string"
                        },
                        "revertCancellationInferred": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "releaseType",
                        "nextVersion",
                        "entries",
                        "markdown",
                        "revertCancellationInferred"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "conventional-release-plan",
                  "version": "0.29.0",
                  "result": {
                    "releaseType": "minor",
                    "nextVersion": "1.3.0",
                    "entries": [
                      {
                        "id": "c1",
                        "sourceIndex": 0,
                        "type": "feat",
                        "scope": "api",
                        "description": "add CSV export",
                        "breaking": false,
                        "releaseEffect": "minor"
                      },
                      {
                        "id": "c2",
                        "sourceIndex": 1,
                        "type": "fix",
                        "scope": null,
                        "description": "reset retry counter",
                        "breaking": false,
                        "releaseEffect": "patch"
                      }
                    ],
                    "markdown": "## 1.3.0\n\n### Features\n- api: add CSV export (c1)\n\n### Fixes\n- reset retry counter (c2)\n",
                    "revertCancellationInferred": false
                  },
                  "provenance": {
                    "inputSha256": "4d87e41a7cedfd885e34012956bc8383d3363a7fd63c73524fa398a8e758d842",
                    "outputSha256": "a9fca5e8c388792b6f50bb334348886b90134c000d8d78935e802777946c7cbd",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/coverage-set-optimize": {
      "post": {
        "operationId": "mpp_coverage_set_optimize",
        "summary": "Exact Declared Coverage Set",
        "description": "Find a proved minimum-cost subset covering up to 12 supplied requirement labels, then minimize cardinality and UTF-16 lexicographic IDs across at most 48 declared candidates.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/coverage-set-optimize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find minimum-cost declared checks covering all supplied requirement labels",
            "Choose an exact small weighted set cover with deterministic tie-breaking"
          ],
          "whenToUse": [
            "Find minimum-cost declared checks covering all supplied requirement labels",
            "Choose an exact small weighted set cover with deterministic tie-breaking"
          ],
          "whenNotToUse": [
            "Real test coverage, code impact, reliability, scheduling, inferred capabilities, personnel selection or high-impact decisions about people",
            "Large or approximate optimization, negative/zero costs, repeated candidates or extra constraints",
            "Fetching files, reading a repository, executing code or tests, contacting agents, publishing releases, or changing remote state"
          ],
          "capabilities": [
            "Declared profile: exact-declared-set-cover-v1",
            "Exact 0/1 bitmask dynamic programming; objective is cost, cardinality, then sorted UTF-16 candidate IDs",
            "Positive integer costs and bounded safe-integer sum; input-order-independent optimum",
            "Infeasible only when union coverage misses requirements; reports sorted missing labels; empty universe has zero-cost optimum",
            "Deterministic supplied-input-only operation; no network, filesystem, shell or current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "exact-declared-set-cover-v1",
            "requirements": 12,
            "candidates": 48,
            "costUnits": 1000000000,
            "totalCostUnits": 48000000000,
            "idUnits": 64,
            "candidateStateTransitions": 196608,
            "candidateRankComparisons": 9437184
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_REQUIREMENT",
            "DUPLICATE_ID",
            "DUPLICATE_COVERAGE",
            "UNKNOWN_REQUIREMENT"
          ],
          "related": [
            "context-budget-pack",
            "workflow-resource-plan",
            "workflow-dag-analyze"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "requirements": {
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    }
                  },
                  "candidates": {
                    "maxItems": 48,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "costUnits": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000000
                        },
                        "covers": {
                          "maxItems": 12,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          }
                        }
                      },
                      "required": [
                        "id",
                        "costUnits",
                        "covers"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "requirements",
                  "candidates"
                ],
                "additionalProperties": false
              },
              "example": {
                "requirements": [
                  "api",
                  "ui",
                  "docs"
                ],
                "candidates": [
                  {
                    "id": "smoke",
                    "costUnits": 4,
                    "covers": [
                      "api",
                      "ui"
                    ]
                  },
                  {
                    "id": "api-only",
                    "costUnits": 2,
                    "covers": [
                      "api"
                    ]
                  },
                  {
                    "id": "ui-only",
                    "costUnits": 3,
                    "covers": [
                      "ui"
                    ]
                  },
                  {
                    "id": "docs",
                    "costUnits": 1,
                    "covers": [
                      "docs"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "coverage-set-optimize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "enum": [
                            "optimal",
                            "infeasible"
                          ]
                        },
                        "selectedIds": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "totalCostUnits": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "coverage": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "requirement": {
                                "type": "string"
                              },
                              "selectedIds": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "required": [
                              "requirement",
                              "selectedIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "uncovered": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "optimalWithinSuppliedModel": {
                          "type": "boolean"
                        },
                        "declaredCoverageOnly": {
                          "type": "boolean",
                          "const": true
                        }
                      },
                      "required": [
                        "status",
                        "selectedIds",
                        "totalCostUnits",
                        "coverage",
                        "uncovered",
                        "optimalWithinSuppliedModel",
                        "declaredCoverageOnly"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "coverage-set-optimize",
                  "version": "0.29.0",
                  "result": {
                    "status": "optimal",
                    "selectedIds": [
                      "docs",
                      "smoke"
                    ],
                    "totalCostUnits": 5,
                    "coverage": [
                      {
                        "requirement": "api",
                        "selectedIds": [
                          "smoke"
                        ]
                      },
                      {
                        "requirement": "docs",
                        "selectedIds": [
                          "docs"
                        ]
                      },
                      {
                        "requirement": "ui",
                        "selectedIds": [
                          "smoke"
                        ]
                      }
                    ],
                    "uncovered": [],
                    "optimalWithinSuppliedModel": true,
                    "declaredCoverageOnly": true
                  },
                  "provenance": {
                    "inputSha256": "11b8523cf1119acb556bbeee278dd3f32753bb6873f40eb4a979953872adf4e5",
                    "outputSha256": "31668e5cc928891467c30f72c5e2a0b379650880d0f37fca4ae0e2fda8d7e9a0",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/icalendar-compose": {
      "post": {
        "operationId": "mpp_icalendar_compose",
        "summary": "Standalone iCalendar Artifact Composer",
        "description": "Create exact UTF-8 iCalendar text for up to 64 supplied standalone date-only or UTC events, with caller UIDs/stamps, escaped literal text and byte-bounded folding; no account changes or invitations.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/icalendar-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Create an ICS file from supplied standalone events",
            "Encode all-day or UTC calendar events with exact literal text and caller identifiers"
          ],
          "whenToUse": [
            "Create an ICS file from supplied standalone events",
            "Encode all-day or UTC calendar events with exact literal text and caller identifiers"
          ],
          "whenNotToUse": [
            "Calendar booking, finding free time, sending invitations or proving import success",
            "Recurrence, attendees, organizers, alarms, URLs, attachments, custom properties, time zones or floating local time",
            "Uploading artifacts, executing database statements, sending invitations, accessing calendars or changing remote state"
          ],
          "capabilities": [
            "Declared profile: rfc5545-standalone-events-v1",
            "Strict Gregorian years 1900–2199; explicit exclusive end, unique caller UID and UTC DTSTAMP",
            "TEXT escaping, fixed property order, final CRLF and Unicode-scalar-safe folding at 75 UTF-8 octets including continuation space",
            "Empty supplied optional text emitted; absent fields omitted; no generated identifiers or timestamps",
            "Deterministic supplied-input-only artifact; no network, filesystem, database, shell, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "events": 64,
            "summaryCodePoints": 1000,
            "locationCodePoints": 1000,
            "descriptionCodePoints": 8000,
            "textBytes": 60000,
            "wireBytes": 120000,
            "physicalLines": 4096,
            "uidBytes": 128,
            "years": "1900–2199",
            "profile": "rfc5545-standalone-events-v1"
          },
          "related": [
            "recurrence-dates-expand",
            "timezone-convert",
            "timestamp-convert"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_UID",
            "INVALID_CALENDAR_DATE",
            "INVALID_UTC_TIME",
            "INVALID_INTERVAL",
            "INVALID_TEXT_CONTROL",
            "TEXT_LIMIT",
            "CALENDAR_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "description": "Declared profile: rfc5545-standalone-events-v1",
                "type": "object",
                "properties": {
                  "events": {
                    "minItems": 1,
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "uid": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "pattern": "^[A-Za-z0-9._@+\\-]+$"
                        },
                        "dtstamp": {
                          "type": "string",
                          "maxLength": 20
                        },
                        "summary": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 2000,
                          "description": "Literal text, at most 1,000 Unicode code points"
                        },
                        "description": {
                          "type": "string",
                          "maxLength": 16000,
                          "description": "Literal text, at most 8,000 Unicode code points"
                        },
                        "location": {
                          "type": "string",
                          "maxLength": 2000,
                          "description": "Literal text, at most 1,000 Unicode code points"
                        },
                        "interval": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "date"
                                },
                                "start": {
                                  "type": "string",
                                  "maxLength": 10
                                },
                                "endExclusive": {
                                  "type": "string",
                                  "maxLength": 10
                                }
                              },
                              "required": [
                                "kind",
                                "start",
                                "endExclusive"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "utc"
                                },
                                "start": {
                                  "type": "string",
                                  "maxLength": 20
                                },
                                "endExclusive": {
                                  "type": "string",
                                  "maxLength": 20
                                }
                              },
                              "required": [
                                "kind",
                                "start",
                                "endExclusive"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        }
                      },
                      "required": [
                        "uid",
                        "dtstamp",
                        "summary",
                        "interval"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "events"
                ],
                "additionalProperties": false
              },
              "example": {
                "events": [
                  {
                    "uid": "review-1@example.invalid",
                    "dtstamp": "2026-10-05T00:00:00Z",
                    "summary": "Release, review",
                    "interval": {
                      "kind": "date",
                      "start": "2026-10-06",
                      "endExclusive": "2026-10-07"
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "icalendar-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "mediaType": {
                          "type": "string",
                          "const": "text/calendar; charset=UTF-8"
                        },
                        "ics": {
                          "type": "string"
                        },
                        "utf8Bytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "eventCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 64
                        }
                      },
                      "required": [
                        "mediaType",
                        "ics",
                        "utf8Bytes",
                        "eventCount"
                      ],
                      "additionalProperties": false,
                      "description": "Artifact result for declared profile: rfc5545-standalone-events-v1"
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "icalendar-compose",
                  "version": "0.29.0",
                  "result": {
                    "mediaType": "text/calendar; charset=UTF-8",
                    "ics": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Agent Service Market//Calendar v1//EN\r\nCALSCALE:GREGORIAN\r\nBEGIN:VEVENT\r\nUID:review-1@example.invalid\r\nDTSTAMP:20261005T000000Z\r\nDTSTART;VALUE=DATE:20261006\r\nDTEND;VALUE=DATE:20261007\r\nSUMMARY:Release\\, review\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n",
                    "utf8Bytes": 278,
                    "eventCount": 1
                  },
                  "provenance": {
                    "inputSha256": "67118ef5cf393e82525bbb883eb96fa446c6e40b85e50ed539246327a6c916a3",
                    "outputSha256": "53ec068d2fa3e46651c70748a9c2cfcab39631bb7d0e5dd3a160cd4bce4fbc46",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/sql-select-compile": {
      "post": {
        "operationId": "mpp_sql_select_compile",
        "summary": "Bound Single-table SELECT Compiler",
        "description": "Compile one strict single-table SELECT AST for SQLite3 or PostgreSQL18 into quoted SQL, ordered bindings and source paths, with bounded predicates and explicit pagination; never execute SQL.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/sql-select-compile.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compile a bounded SELECT query and parameter bindings from a structured plan",
            "Build a single-table SQLite3 or PostgreSQL18 query handoff without interpolating literal values"
          ],
          "whenToUse": [
            "Compile a bounded SELECT query and parameter bindings from a structured plan",
            "Build a single-table SQLite3 or PostgreSQL18 query handoff without interpolating literal values"
          ],
          "whenNotToUse": [
            "Running SQL, database access, schema/type/permission checks or certifying safe execution",
            "Raw SQL, writes, joins, wildcard, aliases, expressions, functions, subqueries, arbitrary SQL dialects, floats or inferred types",
            "Uploading artifacts, executing database statements, sending invitations, accessing calendars or changing remote state"
          ],
          "capabilities": [
            "Declared profile: single-table-bound-select-v1",
            "Always double-quoted conservative identifiers; strings and safe integers bound separately from SQL",
            "Compare, IN, null checks, nested ALL/ANY/NOT; depth-first ordered binding paths including LIMIT/OFFSET",
            "Explicit SQLite3 ?N or PostgreSQL18 $N placeholders; no terminal semicolon or value interpolation",
            "Query syntax artifacts only; database collation, type affinity, cost and permissions are unverified",
            "Deterministic supplied-input-only artifact; no network, filesystem, database, shell, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "columns": 64,
            "orderBy": 8,
            "identifierBytes": 63,
            "predicateNodes": 128,
            "predicateDepth": 8,
            "membershipValues": 64,
            "parameters": 256,
            "bindingTextBytes": 60000,
            "sqlBytes": 16000,
            "limit": 10000,
            "offset": 1000000,
            "profile": "single-table-bound-select-v1"
          },
          "related": [
            "records-filter",
            "records-project",
            "json-schema-check"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_IDENTIFIER",
            "DUPLICATE_COLUMN",
            "INVALID_PARAMETER",
            "EMPTY_PREDICATE",
            "PARAMETER_LIMIT",
            "PARAMETER_TEXT_LIMIT",
            "PREDICATE_LIMIT",
            "SQL_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "description": "Declared profile: single-table-bound-select-v1",
                "type": "object",
                "properties": {
                  "dialect": {
                    "type": "string",
                    "enum": [
                      "sqlite3",
                      "postgresql18"
                    ]
                  },
                  "table": {
                    "type": "string",
                    "maxLength": 1000,
                    "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                  },
                  "columns": {
                    "minItems": 1,
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 1000,
                      "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                    }
                  },
                  "where": {
                    "$ref": "#/paths/~1v1~1mpp~1sql-select-compile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "orderBy": {
                    "default": [],
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "column": {
                          "type": "string",
                          "maxLength": 1000,
                          "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                        },
                        "direction": {
                          "type": "string",
                          "enum": [
                            "asc",
                            "desc"
                          ]
                        }
                      },
                      "required": [
                        "column",
                        "direction"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  },
                  "offset": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  }
                },
                "required": [
                  "dialect",
                  "table",
                  "columns",
                  "limit",
                  "offset"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "compare"
                          },
                          "column": {
                            "type": "string",
                            "maxLength": 1000,
                            "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                          },
                          "op": {
                            "type": "string",
                            "enum": [
                              "eq",
                              "ne",
                              "lt",
                              "lte",
                              "gt",
                              "gte"
                            ]
                          },
                          "value": {
                            "anyOf": [
                              {
                                "type": "string",
                                "maxLength": 60000
                              },
                              {
                                "type": "number"
                              }
                            ],
                            "description": "Literal NUL-free Unicode text or a safe integer; never raw SQL"
                          }
                        },
                        "required": [
                          "kind",
                          "column",
                          "op",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "in"
                          },
                          "column": {
                            "type": "string",
                            "maxLength": 1000,
                            "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                          },
                          "values": {
                            "maxItems": 64,
                            "type": "array",
                            "items": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "maxLength": 60000
                                },
                                {
                                  "type": "number"
                                }
                              ],
                              "description": "Literal NUL-free Unicode text or a safe integer; never raw SQL"
                            }
                          }
                        },
                        "required": [
                          "kind",
                          "column",
                          "values"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "is-null"
                          },
                          "column": {
                            "type": "string",
                            "maxLength": 1000,
                            "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                          }
                        },
                        "required": [
                          "kind",
                          "column"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "is-not-null"
                          },
                          "column": {
                            "type": "string",
                            "maxLength": 1000,
                            "description": "1–63 ASCII letters/digits/underscores, starting with a letter or underscore; always double-quoted"
                          }
                        },
                        "required": [
                          "kind",
                          "column"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "all"
                          },
                          "items": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1mpp~1sql-select-compile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          }
                        },
                        "required": [
                          "kind",
                          "items"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "any"
                          },
                          "items": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1mpp~1sql-select-compile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          }
                        },
                        "required": [
                          "kind",
                          "items"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "not"
                          },
                          "item": {
                            "$ref": "#/paths/~1v1~1mpp~1sql-select-compile/post/requestBody/content/application~1json/schema/$defs/__schema0"
                          }
                        },
                        "required": [
                          "kind",
                          "item"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                }
              },
              "example": {
                "dialect": "postgresql18",
                "table": "tasks",
                "columns": [
                  "id",
                  "title"
                ],
                "where": {
                  "kind": "all",
                  "items": [
                    {
                      "kind": "compare",
                      "column": "state",
                      "op": "eq",
                      "value": "ready"
                    },
                    {
                      "kind": "compare",
                      "column": "priority",
                      "op": "gte",
                      "value": 2
                    }
                  ]
                },
                "orderBy": [
                  {
                    "column": "id",
                    "direction": "asc"
                  }
                ],
                "limit": 10,
                "offset": 0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "sql-select-compile",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "dialect": {
                          "type": "string",
                          "enum": [
                            "sqlite3",
                            "postgresql18"
                          ]
                        },
                        "sql": {
                          "type": "string"
                        },
                        "bindings": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "string",
                                "maxLength": 60000
                              },
                              {
                                "type": "number"
                              }
                            ],
                            "description": "Literal NUL-free Unicode text or a safe integer; never raw SQL"
                          }
                        },
                        "bindingPaths": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "statementCount": {
                          "type": "number",
                          "const": 1
                        },
                        "executed": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "dialect",
                        "sql",
                        "bindings",
                        "bindingPaths",
                        "statementCount",
                        "executed"
                      ],
                      "additionalProperties": false,
                      "description": "Artifact result for declared profile: single-table-bound-select-v1"
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "sql-select-compile",
                  "version": "0.29.0",
                  "result": {
                    "dialect": "postgresql18",
                    "sql": "SELECT \"id\", \"title\" FROM \"tasks\" WHERE (\"state\" = $1 AND \"priority\" >= $2) ORDER BY \"id\" ASC LIMIT $3 OFFSET $4",
                    "bindings": [
                      "ready",
                      2,
                      10,
                      0
                    ],
                    "bindingPaths": [
                      "/where/items/0/value",
                      "/where/items/1/value",
                      "/limit",
                      "/offset"
                    ],
                    "statementCount": 1,
                    "executed": false
                  },
                  "provenance": {
                    "inputSha256": "c469154a069d55fbfdc51d35d602d488d2eadf160e0a41e655056281f02640f5",
                    "outputSha256": "c5ace9156b9a3141378ca64b52da45563bb02e3938768b326825650abbe269e1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/recurrence-dates-expand": {
      "post": {
        "operationId": "mpp_recurrence_dates_expand",
        "summary": "Bounded Date Recurrence Expansion",
        "description": "Expand a strict date-only daily, weekly or monthly rule into a complete bounded window, with COUNT/UNTIL, explicit inclusion/exclusion dates and normalized supported RRULE text; no timezone or account access.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/recurrence-dates-expand.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Expand supplied date-only recurrence rules into explicit occurrence dates",
            "Generate complete daily, weekly or monthly dates inside a bounded window with exclusions"
          ],
          "whenToUse": [
            "Expand supplied date-only recurrence rules into explicit occurrence dates",
            "Generate complete daily, weekly or monthly dates inside a bounded window with exclusions"
          ],
          "whenNotToUse": [
            "General RRULE/ICS parsing, time zones, local times, DST, business calendars or finding free appointment slots",
            "Unbounded history, unsupported recurrence selectors, holiday guessing or scheduling account changes",
            "Uploading artifacts, executing database statements, sending invitations, accessing calendars or changing remote state"
          ],
          "capabilities": [
            "Declared profile: rfc5545-date-recurrence-subset-v1",
            "1900–2199 Gregorian dates; DAILY/WEEKLY/MONTHLY, explicit interval and exactly one COUNT or inclusive UNTIL",
            "Weekly selectors use explicit weekStart; monthly invalid dates skip rather than roll; DTSTART must match selectors",
            "COUNT counts valid rule instances before exclusions/window filtering; explicit inclusions union before exclusions",
            "Separate windowComplete and ruleFullyExpanded facts; capped expansion fails atomically instead of returning a truncated prefix",
            "Deterministic supplied-input-only artifact; no network, filesystem, database, shell, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "originToWindowDays": 3660,
            "visitedDates": 3661,
            "ruleCandidates": 3661,
            "count": 512,
            "outputDates": 512,
            "rdates": 256,
            "exdates": 256,
            "interval": 120,
            "years": "1900–2199",
            "profile": "rfc5545-date-recurrence-subset-v1"
          },
          "related": [
            "icalendar-compose",
            "business-calendar-shift",
            "timezone-convert"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_DATE",
            "INVALID_WINDOW",
            "UNSUPPORTED_RULE",
            "UNSYNCHRONIZED_START",
            "RECURRENCE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "description": "Declared profile: rfc5545-date-recurrence-subset-v1",
                "type": "object",
                "properties": {
                  "dtstart": {
                    "type": "string",
                    "maxLength": 10
                  },
                  "window": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "string",
                        "maxLength": 10
                      },
                      "endExclusive": {
                        "type": "string",
                        "maxLength": 10
                      }
                    },
                    "required": [
                      "start",
                      "endExclusive"
                    ],
                    "additionalProperties": false
                  },
                  "rule": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "DAILY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "count": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 512
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "count"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "DAILY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "until": {
                            "type": "string",
                            "maxLength": 10
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "until"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "WEEKLY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "weekdays": {
                            "minItems": 1,
                            "maxItems": 7,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "enum": [
                                "MO",
                                "TU",
                                "WE",
                                "TH",
                                "FR",
                                "SA",
                                "SU"
                              ]
                            }
                          },
                          "weekStart": {
                            "type": "string",
                            "enum": [
                              "MO",
                              "TU",
                              "WE",
                              "TH",
                              "FR",
                              "SA",
                              "SU"
                            ]
                          },
                          "count": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 512
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "weekdays",
                          "weekStart",
                          "count"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "WEEKLY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "weekdays": {
                            "minItems": 1,
                            "maxItems": 7,
                            "type": "array",
                            "items": {
                              "type": "string",
                              "enum": [
                                "MO",
                                "TU",
                                "WE",
                                "TH",
                                "FR",
                                "SA",
                                "SU"
                              ]
                            }
                          },
                          "weekStart": {
                            "type": "string",
                            "enum": [
                              "MO",
                              "TU",
                              "WE",
                              "TH",
                              "FR",
                              "SA",
                              "SU"
                            ]
                          },
                          "until": {
                            "type": "string",
                            "maxLength": 10
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "weekdays",
                          "weekStart",
                          "until"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "MONTHLY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "monthDays": {
                            "minItems": 1,
                            "maxItems": 31,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 31
                            }
                          },
                          "count": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 512
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "monthDays",
                          "count"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "frequency": {
                            "type": "string",
                            "const": "MONTHLY"
                          },
                          "interval": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 120
                          },
                          "monthDays": {
                            "minItems": 1,
                            "maxItems": 31,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 31
                            }
                          },
                          "until": {
                            "type": "string",
                            "maxLength": 10
                          }
                        },
                        "required": [
                          "frequency",
                          "interval",
                          "monthDays",
                          "until"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "rdates": {
                    "default": [],
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 10
                    }
                  },
                  "exdates": {
                    "default": [],
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 10
                    }
                  }
                },
                "required": [
                  "dtstart",
                  "window",
                  "rule"
                ],
                "additionalProperties": false
              },
              "example": {
                "dtstart": "2026-01-31",
                "window": {
                  "start": "2026-01-31",
                  "endExclusive": "2026-08-01"
                },
                "rule": {
                  "frequency": "MONTHLY",
                  "interval": 1,
                  "monthDays": [
                    31
                  ],
                  "count": 4
                },
                "rdates": [
                  "2026-02-28"
                ],
                "exdates": [
                  "2026-05-31"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "recurrence-dates-expand",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "dates": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "rrule": {
                          "type": "string"
                        },
                        "ruleInstancesScanned": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 3661
                        },
                        "excludedDatesInWindow": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "windowComplete": {
                          "type": "boolean",
                          "const": true
                        },
                        "ruleFullyExpanded": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "dates",
                        "rrule",
                        "ruleInstancesScanned",
                        "excludedDatesInWindow",
                        "windowComplete",
                        "ruleFullyExpanded"
                      ],
                      "additionalProperties": false,
                      "description": "Artifact result for declared profile: rfc5545-date-recurrence-subset-v1"
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "recurrence-dates-expand",
                  "version": "0.29.0",
                  "result": {
                    "dates": [
                      "2026-01-31",
                      "2026-02-28",
                      "2026-03-31",
                      "2026-07-31"
                    ],
                    "rrule": "FREQ=MONTHLY;INTERVAL=1;BYMONTHDAY=31;COUNT=4",
                    "ruleInstancesScanned": 4,
                    "excludedDatesInWindow": [
                      "2026-05-31"
                    ],
                    "windowComplete": true,
                    "ruleFullyExpanded": true
                  },
                  "provenance": {
                    "inputSha256": "10f5a51bd3092752570d268cb0ea17caaeb18c55f4ea1396f704b7cddd83aef3",
                    "outputSha256": "da2ea7e36399a9f04f5529eaeab5d60cf8e1667974afb4cfd2fada4255de4b10",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/corpus-bm25-search": {
      "post": {
        "operationId": "mpp_corpus_bm25_search",
        "summary": "Search a supplied text corpus",
        "description": "Rank supplied documents with fixed-parameter lexical BM25 and exact original UTF-16 token spans. Scores are binary64 logarithm approximations ordered at 12 decimal places, with exact ID ties. No embeddings, persistent index, web search or semantic relevance guarantee.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/corpus-bm25-search.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Rank my supplied documents by lexical BM25",
            "Retrieve matching passages from caller-supplied text with exact token offsets"
          ],
          "whenToUse": [
            "Rank my supplied documents by lexical BM25",
            "Retrieve matching passages from caller-supplied text with exact token offsets"
          ],
          "whenNotToUse": [
            "Web search, semantic/vector search, linguistic segmentation, relevance certification or verifying whether a passage supports a claim",
            "Network calls, external actions, supplied-evidence authenticity or factual correctness certification"
          ],
          "capabilities": [
            "128 supplied documents and 16 queries; k1=1.2, b=0.75; distinct sorted query terms",
            "Unicode Letter/Number followed by Letter/Mark/Number runs, locale-independent lowercase, no normalization",
            "12-decimal approximate scores, exact ID tie-breaks, omitted-candidate and omitted-span evidence",
            "Networkless bounded computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "documents": 128,
            "queries": 16,
            "corpusBytes": 60000,
            "documentBytes": 20000,
            "corpusTokens": 12000,
            "corpusTerms": 4096,
            "queryTerms": 64,
            "queryCodePoints": 512,
            "tokenCodePoints": 128,
            "topK": 20,
            "hitSpans": 20,
            "contributionChecks": 131072
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "TEXT_LIMIT",
            "TOKEN_LIMIT",
            "TERM_LIMIT",
            "TOKEN_LENGTH_LIMIT"
          ],
          "related": [
            "text-chunk",
            "ranking-evaluate",
            "context-budget-pack"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "documents": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 20000
                        }
                      },
                      "required": [
                        "id",
                        "text"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "queries": {
                    "minItems": 1,
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 1024
                        },
                        "topK": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 20
                        }
                      },
                      "required": [
                        "id",
                        "text",
                        "topK"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "documents",
                  "queries"
                ],
                "additionalProperties": false
              },
              "example": {
                "documents": [
                  {
                    "id": "d1",
                    "text": "red fox"
                  },
                  {
                    "id": "d2",
                    "text": "blue dog"
                  }
                ],
                "queries": [
                  {
                    "id": "q1",
                    "text": "red",
                    "topK": 2
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "corpus-bm25-search",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "profile": {
                          "type": "string",
                          "const": "supplied-unicode-word-bm25-v1"
                        },
                        "documentCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "tokenCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "queries": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "ranked",
                                  "empty-query"
                                ]
                              },
                              "terms": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "maxLength": 512
                                }
                              },
                              "candidateCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "omittedCandidates": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "hits": {
                                "maxItems": 20,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    "sourceIndex": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "score": {
                                      "type": "string",
                                      "pattern": "^\\d+\\.\\d{12}$"
                                    },
                                    "matchedTerms": {
                                      "maxItems": 64,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "maxLength": 512
                                      }
                                    },
                                    "spans": {
                                      "maxItems": 20,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "term": {
                                            "type": "string",
                                            "maxLength": 512
                                          },
                                          "start": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991
                                          },
                                          "end": {
                                            "type": "integer",
                                            "minimum": 0,
                                            "maximum": 9007199254740991
                                          }
                                        },
                                        "required": [
                                          "term",
                                          "start",
                                          "end"
                                        ],
                                        "additionalProperties": false
                                      }
                                    },
                                    "omittedSpans": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "sourceIndex",
                                    "score",
                                    "matchedTerms",
                                    "spans",
                                    "omittedSpans"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "id",
                              "status",
                              "terms",
                              "candidateCount",
                              "omittedCandidates",
                              "hits"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "semanticRelevanceVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "scoreArithmetic": {
                          "type": "string",
                          "const": "binary64-logarithm-approximation"
                        },
                        "scoreOrdering": {
                          "type": "string",
                          "const": "fixed-12-decimal-score-descending-then-UTF16-id"
                        },
                        "offsetUnits": {
                          "type": "string",
                          "const": "UTF-16 code units; zero-based, end-exclusive"
                        }
                      },
                      "required": [
                        "advisoryOnly",
                        "externalRequests",
                        "profile",
                        "documentCount",
                        "tokenCount",
                        "queries",
                        "semanticRelevanceVerified",
                        "scoreArithmetic",
                        "scoreOrdering",
                        "offsetUnits"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "corpus-bm25-search",
                  "version": "0.29.0",
                  "result": {
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "profile": "supplied-unicode-word-bm25-v1",
                    "documentCount": 2,
                    "tokenCount": 4,
                    "queries": [
                      {
                        "id": "q1",
                        "status": "ranked",
                        "terms": [
                          "red"
                        ],
                        "candidateCount": 1,
                        "omittedCandidates": 0,
                        "hits": [
                          {
                            "id": "d1",
                            "sourceIndex": 0,
                            "score": "0.693147180560",
                            "matchedTerms": [
                              "red"
                            ],
                            "spans": [
                              {
                                "term": "red",
                                "start": 0,
                                "end": 3
                              }
                            ],
                            "omittedSpans": 0
                          }
                        ]
                      }
                    ],
                    "semanticRelevanceVerified": false,
                    "scoreArithmetic": "binary64-logarithm-approximation",
                    "scoreOrdering": "fixed-12-decimal-score-descending-then-UTF16-id",
                    "offsetUnits": "UTF-16 code units; zero-based, end-exclusive"
                  },
                  "provenance": {
                    "inputSha256": "b0875c7142d0bbaaced040f155f697415bc61a604d6f69e4dda2ab57deae1de9",
                    "outputSha256": "39eac80fbdd9d2318a7ab087a0a3fe92145f6ddb0ebfa26619059e4e5ffaa7d2",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/decimal-distribution-summarize": {
      "post": {
        "operationId": "mpp_decimal_distribution_summarize",
        "summary": "Summarize exact decimal observations",
        "description": "Compute exact reduced-rational descriptive statistics and R type-7 quantiles from supplied decimal strings. Explicit null/error-or-omit policy, empty and singleton results, exact population/sample variance. No square roots, weighting, units, uncertainty or population inference.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/decimal-distribution-summarize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compute exact descriptive mean, variance, median and R7 percentiles from supplied decimal measurements",
            "Summarize decimal observations with explicit missing-value omission evidence"
          ],
          "whenToUse": [
            "Compute exact descriptive mean, variance, median and R7 percentiles from supplied decimal measurements",
            "Summarize decimal observations with explicit missing-value omission evidence"
          ],
          "whenNotToUse": [
            "Significance testing, confidence intervals, population estimates, verified measurements, standard deviation or automatic missing-value imputation",
            "Network calls, external actions, supplied-evidence authenticity or factual correctness certification"
          ],
          "capabilities": [
            "Exact decimal strings up to 24 integer and 18 fraction digits, reduced rational results",
            "R type-7 interpolation only; probability order retained and numerical duplicates reject",
            "Missing indexes explicit; empty observations return zero sum and null other statistics",
            "Networkless bounded computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "values": 1000,
            "quantiles": 21,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "rationalDigits": 2048,
            "arithmeticWorkSteps": 100000,
            "quantileMethod": "R7"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "MISSING_VALUE",
            "INVALID_PROBABILITY",
            "DUPLICATE_PROBABILITY",
            "NUMERIC_COMPLEXITY"
          ],
          "related": [
            "localized-number-parse",
            "records-aggregate",
            "numeric-rounding-check"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "values": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "string",
                          "maxLength": 44,
                          "pattern": "^-?(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "missing": {
                    "type": "string",
                    "enum": [
                      "error",
                      "omit"
                    ]
                  },
                  "quantiles": {
                    "maxItems": 21,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 43,
                      "pattern": "^(?:0|[1-9]\\d{0,23})(?:\\.\\d{1,18})?$"
                    }
                  }
                },
                "required": [
                  "values",
                  "missing",
                  "quantiles"
                ],
                "additionalProperties": false
              },
              "example": {
                "values": [
                  "1.2",
                  "2.4",
                  "4.8",
                  "7.2",
                  null
                ],
                "missing": "omit",
                "quantiles": [
                  "0.25"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "decimal-distribution-summarize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "profile": {
                          "type": "string",
                          "const": "exact-decimal-r7-summary-v1"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "summarized",
                            "empty"
                          ]
                        },
                        "inputCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "observedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "missingCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "omittedIndexes": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991
                          }
                        },
                        "sum": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "maxLength": 2049,
                              "pattern": "^-?(?:0|[1-9]\\d*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "maxLength": 2048,
                              "pattern": "^[1-9]\\d*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "min": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "max": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "mean": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "median": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "populationVariance": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "sampleVariance": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "maxLength": 2049,
                                  "pattern": "^-?(?:0|[1-9]\\d*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "maxLength": 2048,
                                  "pattern": "^[1-9]\\d*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "quantiles": {
                          "maxItems": 21,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "probability": {
                                "type": "string",
                                "maxLength": 43
                              },
                              "value": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 2049,
                                        "pattern": "^-?(?:0|[1-9]\\d*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 2048,
                                        "pattern": "^[1-9]\\d*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "probability",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "quantileMethod": {
                          "type": "string",
                          "const": "R7"
                        },
                        "populationInference": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "advisoryOnly",
                        "externalRequests",
                        "profile",
                        "status",
                        "inputCount",
                        "observedCount",
                        "missingCount",
                        "omittedIndexes",
                        "sum",
                        "min",
                        "max",
                        "mean",
                        "median",
                        "populationVariance",
                        "sampleVariance",
                        "quantiles",
                        "quantileMethod",
                        "populationInference"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "decimal-distribution-summarize",
                  "version": "0.29.0",
                  "result": {
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "profile": "exact-decimal-r7-summary-v1",
                    "status": "summarized",
                    "inputCount": 5,
                    "observedCount": 4,
                    "missingCount": 1,
                    "omittedIndexes": [
                      4
                    ],
                    "sum": {
                      "numerator": "78",
                      "denominator": "5"
                    },
                    "min": {
                      "numerator": "6",
                      "denominator": "5"
                    },
                    "max": {
                      "numerator": "36",
                      "denominator": "5"
                    },
                    "mean": {
                      "numerator": "39",
                      "denominator": "10"
                    },
                    "median": {
                      "numerator": "18",
                      "denominator": "5"
                    },
                    "populationVariance": {
                      "numerator": "531",
                      "denominator": "100"
                    },
                    "sampleVariance": {
                      "numerator": "177",
                      "denominator": "25"
                    },
                    "quantiles": [
                      {
                        "probability": "0.25",
                        "value": {
                          "numerator": "21",
                          "denominator": "10"
                        }
                      }
                    ],
                    "quantileMethod": "R7",
                    "populationInference": false
                  },
                  "provenance": {
                    "inputSha256": "ba43b753b426000bc85f40d002986e7142da63e0e6543574b4175efdf716f060",
                    "outputSha256": "446f17493b36b940a6b3bd24349ac063e1915aafda0117a8c72a76aea9460984",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/message-variants-render": {
      "post": {
        "operationId": "mpp_message_variants_render",
        "summary": "Render supplied message variants",
        "description": "Render bounded literal/argument/select/plural message trees for explicit cases using fixed CLDR47 integer cardinal rules for en/de/ja/ar/pt-BR/pt-PT. Exact branches precede categories; other is required. Returns selected branches and finite case coverage. No translation, escaping, ICU syntax or runtime Intl dependency.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/message-variants-render.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Render supplied plural/select messages into concrete localized preview strings",
            "Preview fixed integer cardinal branches and finite case coverage for supplied message trees"
          ],
          "whenToUse": [
            "Render supplied plural/select messages into concrete localized preview strings",
            "Preview fixed integer cardinal branches and finite case coverage for supplied message trees"
          ],
          "whenNotToUse": [
            "Translate or verify language quality; parse full ICU MessageFormat; decimal/ordinal plurals; format dates/numbers; send messages; escape HTML or SQL",
            "Network calls, external actions, supplied-evidence authenticity or factual correctness certification"
          ],
          "capabilities": [
            "Flat unique-ownership fully reachable trees with all branches and variables validated before rendering",
            "CLDR47-derived integer-only en/de/ja/ar/pt-BR/pt-PT cardinal rules, no locale fallback or runtime Intl",
            "Exact-value overrides and required other branches, literal substitution, branch coverage over supplied cases only",
            "Networkless bounded computation; advisoryOnly=true; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "nodes": 512,
            "branchDepth": 8,
            "branchesPerChoice": 16,
            "variables": 128,
            "cases": 128,
            "literalValueBytes": 60000,
            "caseTextBytes": 20000,
            "totalTextBytes": 200000,
            "renderNodeVisits": 65536,
            "pluralCountMaximum": 1000000000,
            "cldrVersion": "47"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "INVALID_MESSAGE_TREE",
            "DUPLICATE_BRANCH",
            "MISSING_OTHER",
            "VARIABLE_TYPE_CONFLICT",
            "MISSING_VARIABLE",
            "EXTRA_VARIABLE",
            "INVALID_COUNT",
            "TEXT_LIMIT",
            "RENDER_LIMIT"
          ],
          "related": [
            "localization-bundle-build",
            "template-render"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "locale": {
                    "type": "string",
                    "enum": [
                      "en",
                      "de",
                      "ja",
                      "ar",
                      "pt-BR",
                      "pt-PT"
                    ]
                  },
                  "root": {
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 511
                    }
                  },
                  "nodes": {
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "text"
                            },
                            "text": {
                              "type": "string",
                              "maxLength": 60000
                            }
                          },
                          "required": [
                            "kind",
                            "text"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "arg"
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64,
                              "pattern": "^[A-Za-z_][A-Za-z0-9_.-]*$"
                            }
                          },
                          "required": [
                            "kind",
                            "name"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "select"
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64,
                              "pattern": "^[A-Za-z_][A-Za-z0-9_.-]*$"
                            },
                            "options": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "key": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "nodes": {
                                    "maxItems": 512,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 511
                                    }
                                  }
                                },
                                "required": [
                                  "key",
                                  "nodes"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "kind",
                            "name",
                            "options"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "plural"
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64,
                              "pattern": "^[A-Za-z_][A-Za-z0-9_.-]*$"
                            },
                            "exact": {
                              "default": [],
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "value": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000000000
                                  },
                                  "nodes": {
                                    "maxItems": 512,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 511
                                    }
                                  }
                                },
                                "required": [
                                  "value",
                                  "nodes"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "categories": {
                              "minItems": 1,
                              "maxItems": 6,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "category": {
                                    "type": "string",
                                    "enum": [
                                      "zero",
                                      "one",
                                      "two",
                                      "few",
                                      "many",
                                      "other"
                                    ]
                                  },
                                  "nodes": {
                                    "maxItems": 512,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 511
                                    }
                                  }
                                },
                                "required": [
                                  "category",
                                  "nodes"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "kind",
                            "name",
                            "categories"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  },
                  "cases": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "variables": {
                          "type": "object",
                          "propertyNames": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64,
                            "pattern": "^[A-Za-z_][A-Za-z0-9_.-]*$"
                          },
                          "additionalProperties": {
                            "anyOf": [
                              {
                                "type": "string",
                                "maxLength": 60000
                              },
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              }
                            ]
                          }
                        }
                      },
                      "required": [
                        "id",
                        "variables"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "locale",
                  "root",
                  "nodes",
                  "cases"
                ],
                "additionalProperties": false
              },
              "example": {
                "locale": "en",
                "root": [
                  0,
                  1,
                  2,
                  3
                ],
                "nodes": [
                  {
                    "kind": "text",
                    "text": "Hello "
                  },
                  {
                    "kind": "arg",
                    "name": "name"
                  },
                  {
                    "kind": "text",
                    "text": ", "
                  },
                  {
                    "kind": "plural",
                    "name": "count",
                    "exact": [
                      {
                        "value": 0,
                        "nodes": [
                          4
                        ]
                      }
                    ],
                    "categories": [
                      {
                        "category": "one",
                        "nodes": [
                          5
                        ]
                      },
                      {
                        "category": "other",
                        "nodes": [
                          6,
                          7
                        ]
                      }
                    ]
                  },
                  {
                    "kind": "text",
                    "text": "no files"
                  },
                  {
                    "kind": "text",
                    "text": "one file"
                  },
                  {
                    "kind": "arg",
                    "name": "count"
                  },
                  {
                    "kind": "text",
                    "text": " files"
                  }
                ],
                "cases": [
                  {
                    "id": "none",
                    "variables": {
                      "name": "Ana",
                      "count": 0
                    }
                  },
                  {
                    "id": "several",
                    "variables": {
                      "name": "Ana",
                      "count": 2
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "message-variants-render",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "advisoryOnly": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "profile": {
                          "type": "string",
                          "const": "bounded-message-tree-cldr47-integer-v1"
                        },
                        "locale": {
                          "type": "string",
                          "enum": [
                            "en",
                            "de",
                            "ja",
                            "ar",
                            "pt-BR",
                            "pt-PT"
                          ]
                        },
                        "cases": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "text": {
                                "type": "string",
                                "maxLength": 20000
                              },
                              "branches": {
                                "maxItems": 512,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "node": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "selected": {
                                      "type": "string",
                                      "maxLength": 100
                                    }
                                  },
                                  "required": [
                                    "node",
                                    "selected"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "id",
                              "text",
                              "branches"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "coverage": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "node": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "visited": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "maxLength": 100
                                }
                              },
                              "unvisited": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "maxLength": 100
                                }
                              }
                            },
                            "required": [
                              "node",
                              "visited",
                              "unvisited"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "translationVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "escaped": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "advisoryOnly",
                        "externalRequests",
                        "profile",
                        "locale",
                        "cases",
                        "coverage",
                        "translationVerified",
                        "escaped"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "message-variants-render",
                  "version": "0.29.0",
                  "result": {
                    "advisoryOnly": true,
                    "externalRequests": 0,
                    "profile": "bounded-message-tree-cldr47-integer-v1",
                    "locale": "en",
                    "cases": [
                      {
                        "id": "none",
                        "text": "Hello Ana, no files",
                        "branches": [
                          {
                            "node": 3,
                            "selected": "=0"
                          }
                        ]
                      },
                      {
                        "id": "several",
                        "text": "Hello Ana, 2 files",
                        "branches": [
                          {
                            "node": 3,
                            "selected": "other"
                          }
                        ]
                      }
                    ],
                    "coverage": [
                      {
                        "node": 3,
                        "visited": [
                          "=0",
                          "other"
                        ],
                        "unvisited": [
                          "one"
                        ]
                      }
                    ],
                    "translationVerified": false,
                    "escaped": false
                  },
                  "provenance": {
                    "inputSha256": "9c6f1456c7c70aec965865d71fcd320490baa18b73493f18455d3a7dde5e7d88",
                    "outputSha256": "1097155c3e335474e79c1efb7ed8ed6d15ad7d54090e1723725e2d191324b07c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/svg-bar-chart-compose": {
      "post": {
        "operationId": "mpp_svg_bar_chart_compose",
        "summary": "Compose a fixed SVG bar chart",
        "description": "Turn 1–24 supplied labeled nonnegative integer values and an explicit domain into an inert accessible horizontal bar-chart SVG, plain-text alternative and exact geometry.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/svg-bar-chart-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate a standalone SVG bar chart from computed counts",
            "Create a deterministic horizontal chart and text alternative"
          ],
          "whenToUse": [
            "Already-computed nonnegative integer rows with a caller-selected zero-based domain"
          ],
          "whenNotToUse": [
            "Aggregating data, inferring domains, negative/fractional values, log scales, stacked bars or time axes",
            "Rendering, printing, writing files, uploading, publishing, or changing remote state",
            "Supplying custom SVG, HTML, CSS, fonts, images, links, scripts or external resources",
            "Guaranteeing font appearance, printer alignment, source authenticity or accessibility compliance"
          ],
          "capabilities": [
            "Ordered fixed geometry, visible exact values, title/description and caller-prefixed accessible IDs",
            "Escaped literal text in an original fixed inert SVG serializer",
            "Deterministic supplied-input-only artifact with no network, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "svg-nonnegative-horizontal-bars-v1",
            "rows": 24,
            "labelAsciiCharacters": 16,
            "titleScalars": 80,
            "idPrefixCharacters": 32,
            "maximumValue": 1000000000,
            "widthPixels": 720,
            "maximumProjectedResultBytes": 30560
          },
          "related": [
            "decimal-distribution-summarize",
            "records-aggregate",
            "label-sheet-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "TITLE_LIMIT",
            "EMPTY_TITLE",
            "INVALID_TEXT_CONTROL",
            "VALUE_OUTSIDE_DOMAIN"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "idPrefix": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,31}$"
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160,
                    "description": "1–80 Unicode scalars; no controls or XML-disallowed characters"
                  },
                  "domainMax": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000000
                  },
                  "rows": {
                    "minItems": 1,
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 16,
                          "pattern": "^[\\x20-\\x7e]+$"
                        },
                        "value": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000
                        }
                      },
                      "required": [
                        "label",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "idPrefix",
                  "title",
                  "domainMax",
                  "rows"
                ],
                "additionalProperties": false
              },
              "example": {
                "idPrefix": "sales",
                "title": "Units",
                "domainMax": 10,
                "rows": [
                  {
                    "label": "A",
                    "value": 5
                  },
                  {
                    "label": "B",
                    "value": 10
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "svg-bar-chart-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "svg": {
                          "type": "string"
                        },
                        "textAlternative": {
                          "type": "string"
                        },
                        "bars": {
                          "minItems": 1,
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 23
                              },
                              "x": {
                                "type": "number",
                                "const": 180
                              },
                              "y": {
                                "type": "integer",
                                "minimum": 32,
                                "maximum": 768
                              },
                              "width": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 400
                              },
                              "height": {
                                "type": "number",
                                "const": 24
                              }
                            },
                            "required": [
                              "inputIndex",
                              "x",
                              "y",
                              "width",
                              "height"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "svg",
                        "textAlternative",
                        "bars"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "svg-bar-chart-compose",
                  "version": "0.29.0",
                  "result": {
                    "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" xml:space=\"preserve\" width=\"720\" height=\"108\" viewBox=\"0 0 720 108\" role=\"img\" aria-labelledby=\"sales-title sales-desc\"><title id=\"sales-title\">Units</title><desc id=\"sales-desc\">Domain 0 to 10. A: 5; B: 10.</desc><rect width=\"720\" height=\"108\" fill=\"#fff\"/><g fill=\"#000\" font-family=\"monospace\" font-size=\"12\"><text x=\"16\" y=\"20\" textLength=\"36\" lengthAdjust=\"spacingAndGlyphs\">Units</text><text x=\"16\" y=\"50\">A</text><text x=\"700\" y=\"50\" text-anchor=\"end\">5</text><text x=\"16\" y=\"82\">B</text><text x=\"700\" y=\"82\" text-anchor=\"end\">10</text></g><g fill=\"#2457a7\"><rect x=\"180\" y=\"32\" width=\"200\" height=\"24\"/><rect x=\"180\" y=\"64\" width=\"400\" height=\"24\"/></g></svg>\n",
                    "textAlternative": "Units. Domain 0 to 10. A: 5; B: 10.",
                    "bars": [
                      {
                        "inputIndex": 0,
                        "x": 180,
                        "y": 32,
                        "width": 200,
                        "height": 24
                      },
                      {
                        "inputIndex": 1,
                        "x": 180,
                        "y": 64,
                        "width": 400,
                        "height": 24
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "973f898ca2fb35ca2355c298cede3e4fe15e672477d8181c49a61671c6c220b6",
                    "outputSha256": "a8462700e0da6472b73dddabd13ff57e87822365aa8209868de4fe65ae424fce",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/label-sheet-compose": {
      "post": {
        "operationId": "mpp_label_sheet_compose",
        "summary": "Compose printable SVG label sheets",
        "description": "Fit 1–100 short ASCII labels onto supplied integer-micrometre stock, skip first-page used slots and return deterministic row-major placements and up to 20 inert printable SVG sheets.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/label-sheet-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate printable vector inventory label sheets",
            "Paginate short labels into a physical stock grid with used first-page slots"
          ],
          "whenToUse": [
            "Explicit micrometre page, margin, gap and cell dimensions with one short line per label"
          ],
          "whenNotToUse": [
            "Printer control, barcode generation, postal verification, rotation, optimal nesting, supplied fonts or automatic text fitting",
            "Rendering, printing, writing files, uploading, publishing, or changing remote state",
            "Supplying custom SVG, HTML, CSS, fonts, images, links, scripts or external resources",
            "Guaranteeing font appearance, printer alignment, source authenticity or accessibility compliance"
          ],
          "capabilities": [
            "Exact integer grid, physical millimetre SVG sizes, occupied-cell outlines and ordered placement manifest",
            "Explicit 3/5-em text advance, quarter-em descent reserve and fixed 2,000 micrometre padding",
            "Escaped literal text in an original fixed inert SVG serializer",
            "Deterministic supplied-input-only artifact with no network, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "micrometre-grid-labels-v1",
            "labels": 100,
            "labelAsciiCharacters": 16,
            "pages": 20,
            "pageDimensionUm": 1000000,
            "minimumMarginUm": 50,
            "outlineStrokeUm": 100,
            "paddingUm": 2000,
            "descentReserve": "ceil(fontSizeUm / 4)",
            "maximumProjectedResultBytes": 111000
          },
          "related": [
            "svg-bar-chart-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "LABEL_WHITESPACE",
            "LABEL_TEXT_FIT",
            "NO_LABEL_CAPACITY",
            "START_SLOT_OUTSIDE_GRID",
            "PAGE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "pageWidthUm": {
                    "type": "integer",
                    "minimum": 10000,
                    "maximum": 1000000
                  },
                  "pageHeightUm": {
                    "type": "integer",
                    "minimum": 10000,
                    "maximum": 1000000
                  },
                  "marginXUm": {
                    "type": "integer",
                    "minimum": 50,
                    "maximum": 1000000
                  },
                  "marginYUm": {
                    "type": "integer",
                    "minimum": 50,
                    "maximum": 1000000
                  },
                  "labelWidthUm": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000
                  },
                  "labelHeightUm": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000
                  },
                  "gapXUm": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "gapYUm": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "fontSizeUm": {
                    "type": "integer",
                    "minimum": 1000,
                    "maximum": 10000
                  },
                  "startSlot": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "labels": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 16,
                      "pattern": "^[\\x20-\\x7e]+$"
                    }
                  }
                },
                "required": [
                  "pageWidthUm",
                  "pageHeightUm",
                  "marginXUm",
                  "marginYUm",
                  "labelWidthUm",
                  "labelHeightUm",
                  "gapXUm",
                  "gapYUm",
                  "fontSizeUm",
                  "startSlot",
                  "labels"
                ],
                "additionalProperties": false
              },
              "example": {
                "pageWidthUm": 100000,
                "pageHeightUm": 60000,
                "marginXUm": 5000,
                "marginYUm": 5000,
                "labelWidthUm": 40000,
                "labelHeightUm": 20000,
                "gapXUm": 10000,
                "gapYUm": 10000,
                "fontSizeUm": 3000,
                "startSlot": 0,
                "labels": [
                  "A-01",
                  "B-02"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "label-sheet-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "columns": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000
                        },
                        "rows": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000
                        },
                        "capacityPerPage": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1000000
                        },
                        "pageCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 20
                        },
                        "placements": {
                          "minItems": 1,
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 99
                              },
                              "pageIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 19
                              },
                              "row": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              },
                              "column": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              },
                              "xUm": {
                                "type": "integer",
                                "minimum": 50,
                                "maximum": 1000000
                              },
                              "yUm": {
                                "type": "integer",
                                "minimum": 50,
                                "maximum": 1000000
                              },
                              "widthUm": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 1000000
                              },
                              "heightUm": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 1000000
                              }
                            },
                            "required": [
                              "inputIndex",
                              "pageIndex",
                              "row",
                              "column",
                              "xUm",
                              "yUm",
                              "widthUm",
                              "heightUm"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "pages": {
                          "minItems": 1,
                          "maxItems": 20,
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "columns",
                        "rows",
                        "capacityPerPage",
                        "pageCount",
                        "placements",
                        "pages"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "label-sheet-compose",
                  "version": "0.29.0",
                  "result": {
                    "columns": 2,
                    "rows": 2,
                    "capacityPerPage": 4,
                    "pageCount": 1,
                    "placements": [
                      {
                        "inputIndex": 0,
                        "pageIndex": 0,
                        "row": 0,
                        "column": 0,
                        "xUm": 5000,
                        "yUm": 5000,
                        "widthUm": 40000,
                        "heightUm": 20000
                      },
                      {
                        "inputIndex": 1,
                        "pageIndex": 0,
                        "row": 0,
                        "column": 1,
                        "xUm": 55000,
                        "yUm": 5000,
                        "widthUm": 40000,
                        "heightUm": 20000
                      }
                    ],
                    "pages": [
                      "<svg xmlns=\"http://www.w3.org/2000/svg\" xml:space=\"preserve\" width=\"100mm\" height=\"60mm\" viewBox=\"0 0 100000 60000\" role=\"img\"><title>Label sheet 1 of 1</title><g fill=\"none\" stroke=\"#000\" stroke-width=\"100\"><rect x=\"5000\" y=\"5000\" width=\"40000\" height=\"20000\"/><rect x=\"55000\" y=\"5000\" width=\"40000\" height=\"20000\"/></g><g fill=\"#000\" font-family=\"monospace\" font-size=\"3000\"><text x=\"7000\" y=\"10000\" textLength=\"7200\" lengthAdjust=\"spacingAndGlyphs\">A-01</text><text x=\"57000\" y=\"10000\" textLength=\"7200\" lengthAdjust=\"spacingAndGlyphs\">B-02</text></g></svg>\n"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "d99f5928e42fe224c3552c626fdcc2e8132b68bc3aee914dac3ce1aea312c353",
                    "outputSha256": "2120862f692df28a7678a5660b924ae72e56404af7aa1b2d4f823ed7cc929da7",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/ustar-bundle-compose": {
      "post": {
        "operationId": "mpp_ustar_bundle_compose",
        "summary": "Reproducible portable USTAR bundle composer",
        "description": "WHEN TO USE: Package 1–32 supplied named UTF-8 or binary artifacts into exact reproducible regular-file USTAR bytes, canonical Base64, SHA-256 and a sorted source-index/offset manifest. Restricted portable ASCII relative paths, fixed nonexecutable metadata, no compression, archive extraction, filesystem reads/writes or universal safe-extraction claim.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/ustar-bundle-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Package supplied named artifacts as an exact reproducible tar archive",
            "Create a byte-addressed bundle with content hashes and source indexes"
          ],
          "whenToUse": [
            "Package supplied named artifacts as an exact reproducible tar archive",
            "Create a byte-addressed bundle with content hashes and source indexes"
          ],
          "whenNotToUse": [
            "ZIP, gzip, compression, directories, links, devices, executable modes, permissions or ownership preservation",
            "Reading paths, extracting archives, PAX/GNU extensions or universal cross-platform extraction safety",
            "Sending, uploading, extracting archives, writing files, authenticating identities, or changing external state"
          ],
          "capabilities": [
            "Profile portable-regular-ustar-v1; ASCII-byte path ordering with case-insensitive collision rejection",
            "Fixed 0644 regular files; zero uid/gid/mtime, empty owner names; exact two-block terminator",
            "SHA-256 over decoded bytes; sidecar manifest is not an archive member",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "portable-regular-ustar-v1",
            "files": 32,
            "pathBytes": 100,
            "segmentBytes": 64,
            "payloadBytes": 60000,
            "archiveBytes": 93696,
            "extraction": "never performed; consumers still require safe extraction"
          },
          "related": [
            "oci-artifact-compose",
            "multipart-form-encode",
            "content-digest"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_PATH",
            "DUPLICATE_PATH",
            "PATH_COLLISION",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "ARCHIVE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "files": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 80000
                        }
                      },
                      "required": [
                        "path",
                        "encoding",
                        "data"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "files"
                ],
                "additionalProperties": false
              },
              "example": {
                "files": [
                  {
                    "path": "a.txt",
                    "encoding": "utf8",
                    "data": "hi\n"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "ustar-bundle-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "encoding": {
                          "type": "string",
                          "const": "base64"
                        },
                        "archive": {
                          "type": "string",
                          "maxLength": 124928
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1536,
                          "maximum": 93696
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "manifest": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 31
                              },
                              "path": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "byteLength": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "sha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "headerOffset": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 92160
                              },
                              "dataOffset": {
                                "type": "integer",
                                "minimum": 512,
                                "maximum": 92672
                              }
                            },
                            "required": [
                              "inputIndex",
                              "path",
                              "byteLength",
                              "sha256",
                              "headerOffset",
                              "dataOffset"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "encoding",
                        "archive",
                        "byteLength",
                        "sha256",
                        "manifest"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "ustar-bundle-compose",
                  "version": "0.29.0",
                  "result": {
                    "encoding": "base64",
                    "archive": "YS50eHQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADAwMDA2NDQAMDAwMDAwMAAwMDAwMDAwADAwMDAwMDAwMDAzADAwMDAwMDAwMDAwADAwNjcxNwAgMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB1c3RhcgAwMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABoaQoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=",
                    "byteLength": 2048,
                    "sha256": "8909eea3aedf7c1309a054eed68c58f7506ca7e9fcb198beb7e89b408912d827",
                    "manifest": [
                      {
                        "inputIndex": 0,
                        "path": "a.txt",
                        "byteLength": 3,
                        "sha256": "98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4",
                        "headerOffset": 0,
                        "dataOffset": 512
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "466d72e01f0ff4307aa75b44e6b6878bb3d1a57ccf05469a06d81e78042cef93",
                    "outputSha256": "88111b382c61bb554da6987a518ee9bb429f99606ebcfa5e4c95f9f97953c921",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/mime-email-compose": {
      "post": {
        "operationId": "mpp_mime_email_compose",
        "summary": "Inert RFC email message composer",
        "description": "WHEN TO USE: Create exact inert .eml message text from caller-supplied From, ordered To, UTC timestamp, Message-ID, subject and text. Restricted ASCII mailboxes, deterministic MIME Base64 UTF-8 body and safe folded encoded subjects. Does not send email, create mailbox drafts, authenticate identities, look up domains or promise delivery.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/mime-email-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compose a complete deterministic .eml draft artifact for later caller-controlled import or transport",
            "Encode explicit sender, recipients, timestamp, message ID and plain text as an RFC MIME message"
          ],
          "whenToUse": [
            "Compose a complete deterministic .eml draft artifact for later caller-controlled import or transport",
            "Encode explicit sender, recipients, timestamp, message ID and plain text as an RFC MIME message"
          ],
          "whenNotToUse": [
            "Sending email, mailbox access, deliverability checks, DNS or authenticated sender identity",
            "HTML, attachments, display names, quoted mailboxes, groups, SMTPUTF8, Cc/Bcc, custom headers or DKIM",
            "Sending, uploading, extracting archives, writing files, authenticating identities, or changing external state"
          ],
          "capabilities": [
            "Profile rfc5322-text-message-v1; eight fixed headers and Base64 text/plain UTF-8",
            "Supplied whole-second UTC date and message ID; exact CRLF body normalization without adding decoded newlines",
            "Subject encoded words split only at scalar boundaries; literal encoded-word-looking text cannot become MIME syntax",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "rfc5322-text-message-v1",
            "recipients": 10,
            "mailboxBytes": 254,
            "localPartBytes": 64,
            "subjectScalars": 200,
            "subjectBytes": 600,
            "sourceBodyBytes": 40000,
            "canonicalBodyBytes": 40000,
            "wireBytes": 70000,
            "headerLineBytes": 998,
            "encodedWordSourceBytes": 42,
            "identities": "caller claims, not authenticated"
          },
          "related": [
            "multipart-form-encode",
            "icalendar-compose",
            "email-domain-readiness"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_MAILBOX",
            "INVALID_TIMESTAMP",
            "HEADER_CONTROL",
            "DUPLICATE_RECIPIENT",
            "SUBJECT_LIMIT",
            "SUBJECT_WHITESPACE",
            "BODY_CONTROL",
            "TEXT_LIMIT",
            "HEADER_LIMIT",
            "WIRE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "from": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 254
                  },
                  "to": {
                    "minItems": 1,
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 3,
                      "maxLength": 254
                    }
                  },
                  "sentAt": {
                    "type": "string",
                    "minLength": 20,
                    "maxLength": 20
                  },
                  "messageId": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 254
                  },
                  "subject": {
                    "type": "string",
                    "maxLength": 400
                  },
                  "text": {
                    "type": "string",
                    "maxLength": 40000
                  }
                },
                "required": [
                  "from",
                  "to",
                  "sentAt",
                  "messageId",
                  "subject",
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "from": "a@example.invalid",
                "to": [
                  "b@example.invalid"
                ],
                "sentAt": "2026-10-05T00:00:00Z",
                "messageId": "demo@example.invalid",
                "subject": "Test",
                "text": "Oi\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "mime-email-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "eml": {
                          "type": "string",
                          "maxLength": 70000
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 70000
                        },
                        "canonicalText": {
                          "type": "string",
                          "maxLength": 40000
                        }
                      },
                      "required": [
                        "eml",
                        "byteLength",
                        "canonicalText"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "mime-email-compose",
                  "version": "0.29.0",
                  "result": {
                    "eml": "From: a@example.invalid\r\nTo: b@example.invalid\r\nDate: Mon, 05 Oct 2026 00:00:00 +0000\r\nMessage-ID: <demo@example.invalid>\r\nSubject: Test\r\nMIME-Version: 1.0\r\nContent-Type: text/plain; charset=UTF-8\r\nContent-Transfer-Encoding: base64\r\n\r\nT2kNCg==\r\n",
                    "byteLength": 245,
                    "canonicalText": "Oi\r\n"
                  },
                  "provenance": {
                    "inputSha256": "3f095540c31fbbb0c75d82e8d8f54fbceb17631950ed8c38ee5ab13214d1de60",
                    "outputSha256": "ce2296649f70300609d6e02b285b90485aa4e22b3f73ea5eeb392d1d3c42b489",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/gfm-table-compose": {
      "post": {
        "operationId": "mpp_gfm_table_compose",
        "summary": "Literal-cell GFM table composer",
        "description": "WHEN TO USE: Turn an explicit rectangular string matrix into a paste-ready GitHub Flavored Markdown table with exact literal-cell escaping and supplied column alignments. Escapes every ASCII punctuation character, preserving cell text in the declared GFM profile. ASCII @ is rejected to prevent GFM email autolinks. No raw Markdown, HTML, links, newline substitution, display-width padding or non-GFM rendering guarantee.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/gfm-table-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compose paste-ready literal-cell GFM tables from supplied rows",
            "Serialize a rectangular string matrix as Markdown with explicit column alignments"
          ],
          "whenToUse": [
            "Compose paste-ready literal-cell GFM tables from supplied rows",
            "Serialize a rectangular string matrix as Markdown with explicit column alignments"
          ],
          "whenNotToUse": [
            "ASCII @ or email-address cells; GFM email autolinking cannot be suppressed with punctuation escapes",
            "Parsing tables, CSV conversion, raw Markdown or HTML cells, links, code spans or multiline cells",
            "Pixel alignment, display-width padding or exact behavior on non-GFM renderers; browsers may collapse repeated spaces",
            "Sending, uploading, extracting archives, writing files, authenticating identities, or changing external state"
          ],
          "capabilities": [
            "Profile gfm-literal-table-v1; ASCII @ is rejected; every other CommonMark ASCII punctuation character is backslash-escaped",
            "Exact rectangular dimensions, explicit left/center/right alignment and final LF",
            "Empty cells and duplicate headers remain strings, without implicit object conversion",
            "Deterministic supplied-input-only artifact; zero external requests and no current-time dependence"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "gfm-literal-table-v1",
            "columns": 20,
            "rows": 100,
            "cellScalars": 200,
            "aggregateCellBytes": 20000,
            "atSign": "rejected to prevent unavoidable GFM email autolinking",
            "renderedSpaces": "browser layout may collapse repeated spaces"
          },
          "related": [
            "markdown-table-extract",
            "csv-serialize",
            "record-relations"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "TABLE_SHAPE",
            "CELL_AUTOLINK",
            "CELL_LIMIT",
            "CELL_CONTROL",
            "CELL_WHITESPACE",
            "TABLE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "headers": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 400,
                      "description": "Literal GFM cell: at most 200 Unicode scalars; no controls, leading/trailing ASCII spaces or ASCII @ (email autolinking cannot otherwise be suppressed)."
                    }
                  },
                  "align": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "left",
                        "center",
                        "right"
                      ]
                    }
                  },
                  "rows": {
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 20,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "maxLength": 400,
                        "description": "Literal GFM cell: at most 200 Unicode scalars; no controls, leading/trailing ASCII spaces or ASCII @ (email autolinking cannot otherwise be suppressed)."
                      }
                    }
                  }
                },
                "required": [
                  "headers",
                  "align",
                  "rows"
                ],
                "additionalProperties": false
              },
              "example": {
                "headers": [
                  "Name",
                  "Note"
                ],
                "align": [
                  "left",
                  "right"
                ],
                "rows": [
                  [
                    "A|B",
                    "<b>"
                  ]
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "gfm-table-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "markdown": {
                          "type": "string",
                          "maxLength": 50000
                        },
                        "rowCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100
                        },
                        "columnCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 20
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 50000
                        }
                      },
                      "required": [
                        "markdown",
                        "rowCount",
                        "columnCount",
                        "byteLength"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "gfm-table-compose",
                  "version": "0.29.0",
                  "result": {
                    "markdown": "| Name | Note |\n| :--- | ---: |\n| A\\|B | \\<b\\> |\n",
                    "rowCount": 1,
                    "columnCount": 2,
                    "byteLength": 49
                  },
                  "provenance": {
                    "inputSha256": "bd997c57f922649cb03ae151e68001c13b51aab9d7837893267028102ddd8e84",
                    "outputSha256": "371771ed09a9e61e0fb6a7bf77671979eefd5af875495834ddcd0608ef42c070",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/qr-code-compose": {
      "post": {
        "operationId": "mpp_qr_code_compose",
        "summary": "Compose an ASCII QR matrix or SVG",
        "description": "Encode 1–64 supplied printable ASCII bytes as a bounded Model 2 QR code using explicit version, error correction and mask; return unbordered module rows or inert black-and-white SVG with a four-module quiet zone.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/qr-code-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate a reproducible QR handoff label from ASCII text",
            "Create a decodable QR SVG or raw module matrix with explicit settings"
          ],
          "whenToUse": [
            "Caller-selected version 1–5, ECC and mask for a short printable ASCII payload"
          ],
          "whenNotToUse": [
            "Opening or judging encoded URLs, verifying destination safety, authenticating payloads or transferring funds",
            "Unicode/ECI, arbitrary binary, automatic segmentation/version/ECC, Kanji, micro-QR, logos, colors or camera/print reliability guarantees",
            "Rendering, printing, writing files, uploading, publishing, or changing remote state",
            "Supplying custom SVG, HTML, CSS, fonts, images, links, scripts or external resources",
            "Guaranteeing font appearance, printer alignment, source authenticity or accessibility compliance"
          ],
          "capabilities": [
            "Pinned maintained qr@0.7.2 byte-mode encoder, no handwritten QR engine",
            "Independent synthetic ZXing decoder verification; deterministic module matrix and original escaped SVG serialization",
            "Escaped literal text in an original fixed inert SVG serializer",
            "Deterministic supplied-input-only artifact with no network, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "qr-model2-ascii-byte-v1",
            "payloadAsciiBytes": 64,
            "minimumVersion": 1,
            "maximumVersion": 5,
            "maximumModuleCount": 37,
            "quietZoneModules": 4,
            "maximumProjectedResultBytes": 20000
          },
          "related": [
            "label-sheet-compose",
            "svg-bar-chart-compose",
            "url-inspect"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "CAPACITY_EXCEEDED",
            "ENCODER_FAILURE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64,
                    "pattern": "^[\\x20-\\x7e]+$"
                  },
                  "version": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 5
                  },
                  "errorCorrection": {
                    "type": "string",
                    "enum": [
                      "L",
                      "M",
                      "Q",
                      "H"
                    ]
                  },
                  "mask": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 7
                  },
                  "output": {
                    "type": "string",
                    "enum": [
                      "matrix",
                      "svg"
                    ]
                  }
                },
                "required": [
                  "text",
                  "version",
                  "errorCorrection",
                  "mask",
                  "output"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "A",
                "version": 1,
                "errorCorrection": "M",
                "mask": 0,
                "output": "matrix"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "qr-code-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "mode": {
                              "type": "string",
                              "const": "byte"
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 5
                            },
                            "errorCorrection": {
                              "type": "string",
                              "enum": [
                                "L",
                                "M",
                                "Q",
                                "H"
                              ]
                            },
                            "mask": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 7
                            },
                            "moduleCount": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "const": 21
                                },
                                {
                                  "type": "number",
                                  "const": 25
                                },
                                {
                                  "type": "number",
                                  "const": 29
                                },
                                {
                                  "type": "number",
                                  "const": 33
                                },
                                {
                                  "type": "number",
                                  "const": 37
                                }
                              ]
                            },
                            "quietZone": {
                              "type": "number",
                              "const": 4
                            },
                            "matrix": {
                              "minItems": 21,
                              "maxItems": 37,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[01]{21,37}$"
                              }
                            }
                          },
                          "required": [
                            "mode",
                            "version",
                            "errorCorrection",
                            "mask",
                            "moduleCount",
                            "quietZone",
                            "matrix"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "mode": {
                              "type": "string",
                              "const": "byte"
                            },
                            "version": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 5
                            },
                            "errorCorrection": {
                              "type": "string",
                              "enum": [
                                "L",
                                "M",
                                "Q",
                                "H"
                              ]
                            },
                            "mask": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 7
                            },
                            "moduleCount": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "const": 21
                                },
                                {
                                  "type": "number",
                                  "const": 25
                                },
                                {
                                  "type": "number",
                                  "const": 29
                                },
                                {
                                  "type": "number",
                                  "const": 33
                                },
                                {
                                  "type": "number",
                                  "const": 37
                                }
                              ]
                            },
                            "quietZone": {
                              "type": "number",
                              "const": 4
                            },
                            "svg": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "mode",
                            "version",
                            "errorCorrection",
                            "mask",
                            "moduleCount",
                            "quietZone",
                            "svg"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "qr-code-compose",
                  "version": "0.29.0",
                  "result": {
                    "mode": "byte",
                    "version": 1,
                    "errorCorrection": "M",
                    "mask": 0,
                    "moduleCount": 21,
                    "quietZone": 4,
                    "matrix": [
                      "111111100111001111111",
                      "100000101011101000001",
                      "101110100010001011101",
                      "101110100100001011101",
                      "101110101100101011101",
                      "100000100010101000001",
                      "111111101010101111111",
                      "000000000001100000000",
                      "101010100011000010010",
                      "100111000100001000110",
                      "010000101110100010001",
                      "101010000110001000100",
                      "101001101010101010101",
                      "000000001111010101010",
                      "111111100001011101111",
                      "100000100101110111000",
                      "101110101101011101101",
                      "101110100000001000110",
                      "101110101100100010001",
                      "100000100110001000110",
                      "111111101000101010111"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "22c0c673c1ebd25bc94fdf4bd3a38024646b8f8d3ff9eb2bb358a9624bdf9d12",
                    "outputSha256": "89e8b2d4b7d5671b44b869934c159f4c635f627316c8f5cc8ef089d71ac07a28",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/zip-store-compose": {
      "post": {
        "operationId": "mpp_zip_store_compose",
        "summary": "Reproducible portable ZIP STORE composer",
        "description": "WHEN TO USE: Package 1–32 supplied files as exact deterministic ZIP STORE bytes, CRC32, SHA-256 and member offsets for ZIP consumers. Restricted portable ASCII paths, fixed metadata, no compression, extraction, ZIP64, encryption, links or executable permissions. Does not create office-document formats or guarantee safe consumer extraction.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/zip-store-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Package supplied files as a reproducible uncompressed ZIP archive",
            "Create a ZIP container for a consumer that does not accept TAR"
          ],
          "whenToUse": [
            "Need exact classic ZIP STORE bytes from explicit named file data"
          ],
          "whenNotToUse": [
            "Reading or extracting ZIP, compression, encryption, signing, ZIP64 or filesystem paths",
            "Creating DOCX, XLSX or EPUB semantic package formats",
            "Extracting archives, writing files, uploading, publishing, or changing external state"
          ],
          "capabilities": [
            "Profile portable-store-zip-v1; exact ASCII path ordering, no name or ancestor collisions",
            "Fixed DOS 1980-01-01 00:00:00, creator 0, versions 10, flags 0 and archive attribute 0x20",
            "CRC32 and SHA-256 of each payload plus archive SHA-256; integrity is not authenticity",
            "Deterministic supplied-input-only bytes; no network, clock, randomness or decompression"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "portable-store-zip-v1",
            "files": 32,
            "pathBytes": 100,
            "segmentBytes": 64,
            "payloadBytes": 60000,
            "archiveBytes": 68854
          },
          "related": [
            "ustar-bundle-compose",
            "content-digest",
            "multipart-form-encode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "INVALID_PATH",
            "DUPLICATE_PATH",
            "PATH_COLLISION",
            "ARCHIVE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "files": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 80000
                        }
                      },
                      "required": [
                        "path",
                        "encoding",
                        "data"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "files"
                ],
                "additionalProperties": false
              },
              "example": {
                "files": [
                  {
                    "path": "a.txt",
                    "encoding": "utf8",
                    "data": "hi\n"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "zip-store-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "encoding": {
                          "type": "string",
                          "const": "base64"
                        },
                        "archive": {
                          "type": "string",
                          "maxLength": 91808
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 100,
                          "maximum": 68854
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "manifest": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 31
                              },
                              "path": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "byteLength": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "crc32": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{8}$"
                              },
                              "sha256": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              },
                              "headerOffset": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 68854
                              },
                              "dataOffset": {
                                "type": "integer",
                                "minimum": 31,
                                "maximum": 68854
                              }
                            },
                            "required": [
                              "inputIndex",
                              "path",
                              "byteLength",
                              "crc32",
                              "sha256",
                              "headerOffset",
                              "dataOffset"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "encoding",
                        "archive",
                        "byteLength",
                        "sha256",
                        "manifest"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "zip-store-compose",
                  "version": "0.29.0",
                  "result": {
                    "encoding": "base64",
                    "archive": "UEsDBAoAAAAAAAAAIQB6em/tAwAAAAMAAAAFAAAAYS50eHRoaQpQSwECCgAKAAAAAAAAACEAenpv7QMAAAADAAAABQAAAAAAAAAAACAAAAAAAAAAYS50eHRQSwUGAAAAAAEAAQAzAAAAJgAAAAAA",
                    "byteLength": 111,
                    "sha256": "e234d8c82aedfe28cb160a03f2862eb4737208ffb98f7695f69b4638b880a625",
                    "manifest": [
                      {
                        "inputIndex": 0,
                        "path": "a.txt",
                        "byteLength": 3,
                        "crc32": "ed6f7a7a",
                        "sha256": "98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4",
                        "headerOffset": 0,
                        "dataOffset": 35
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "466d72e01f0ff4307aa75b44e6b6878bb3d1a57ccf05469a06d81e78042cef93",
                    "outputSha256": "99ba12cd80aea4a9952cbbad1e4da78c8e6b25d504f525006f6cc04a3159502f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/text-bytes-transcode": {
      "post": {
        "operationId": "mpp_text_bytes_transcode",
        "summary": "Strict explicit Unicode and Latin1 byte transcoder",
        "description": "WHEN TO USE: Convert caller-supplied Base64 text-file bytes between explicit UTF-8, UTF-16LE, UTF-16BE and reversible Latin1 byte mapping with strict BOM rules. Rejects malformed sequences and unrepresentable scalars without replacements. No charset detection, Windows-1252 aliases, normalization, newline conversion or plaintext echo.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-bytes-transcode.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Convert supplied file bytes to an explicitly declared importer encoding",
            "Strictly transcode UTF-8 UTF-16 and true Latin1 byte-map data"
          ],
          "whenToUse": [
            "Know both source and target encoding and explicit initial-BOM policy"
          ],
          "whenNotToUse": [
            "Guessing encodings, repairing mojibake, lossy replacement, newline conversion or Unicode normalization",
            "Windows-1252, ASCII aliases, ISO-8859-1 WHATWG label handling or arbitrary legacy code pages",
            "Blind transcoding of fixed byte-column files whose layout depends on original encoding",
            "Extracting archives, writing files, uploading, publishing, or changing external state"
          ],
          "capabilities": [
            "Profile strict-unicode-latin1-bytes-v1; byte N maps exactly to U+00NN including 0x80–0x9F",
            "Remove at most one declared initial BOM; preserve subsequent U+FEFF; opposite UTF-16 BOM rejected",
            "Strict scalar validation and exact target-size preflight before output allocation",
            "Deterministic supplied-input-only bytes; no network, clock, randomness or decompression"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "strict-unicode-latin1-bytes-v1",
            "decodedInputBytes": 60000,
            "scalars": 60000,
            "encodedOutputBytes": 120003
          },
          "related": [
            "base64-convert",
            "blob-decode",
            "multipart-form-encode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "BOM_POLICY",
            "BOM_MISMATCH",
            "BOM_FORBIDDEN",
            "BOM_REQUIRED",
            "INVALID_TEXT_BYTES",
            "SCALAR_LIMIT",
            "UNREPRESENTABLE_SCALAR",
            "TEXT_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "data": {
                    "type": "string",
                    "maxLength": 80000
                  },
                  "from": {
                    "type": "string",
                    "enum": [
                      "utf8",
                      "utf16le",
                      "utf16be",
                      "latin1-byte-map"
                    ]
                  },
                  "to": {
                    "type": "string",
                    "enum": [
                      "utf8",
                      "utf16le",
                      "utf16be",
                      "latin1-byte-map"
                    ]
                  },
                  "inputBom": {
                    "type": "string",
                    "enum": [
                      "forbid",
                      "strip-if-present",
                      "require"
                    ]
                  },
                  "outputBom": {
                    "type": "string",
                    "enum": [
                      "omit",
                      "add"
                    ]
                  }
                },
                "required": [
                  "data",
                  "from",
                  "to",
                  "inputBom",
                  "outputBom"
                ],
                "additionalProperties": false
              },
              "example": {
                "data": "Q2Fm6Q==",
                "from": "latin1-byte-map",
                "to": "utf16le",
                "inputBom": "forbid",
                "outputBom": "add"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-bytes-transcode",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "encoding": {
                          "type": "string",
                          "const": "base64"
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 160004
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 120003
                        },
                        "scalarCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 60000
                        },
                        "inputBomRemoved": {
                          "type": "boolean"
                        },
                        "outputBomAdded": {
                          "type": "boolean"
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        }
                      },
                      "required": [
                        "encoding",
                        "data",
                        "byteLength",
                        "scalarCount",
                        "inputBomRemoved",
                        "outputBomAdded",
                        "sha256"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-bytes-transcode",
                  "version": "0.29.0",
                  "result": {
                    "encoding": "base64",
                    "data": "//5DAGEAZgDpAA==",
                    "byteLength": 10,
                    "scalarCount": 4,
                    "inputBomRemoved": false,
                    "outputBomAdded": true,
                    "sha256": "01a70ae1886925565f6859a2bf3ec11488db5153aed684cbaec5f3873c0a2a86"
                  },
                  "provenance": {
                    "inputSha256": "04a6037740625343feb9dfbc365b5bc359eb05c2228270e4b740539df50ee265",
                    "outputSha256": "82b19e8ba47311b957cb023deefd906f4c8f2f4a6727ce1427b32da3f2ea0a3b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/png-selected-chunks-remove": {
      "post": {
        "operationId": "mpp_png_selected_chunks_remove",
        "summary": "PNG framed selected-chunk removal",
        "description": "WHEN TO USE: Remove every PNG chunk of explicitly selected tEXt, zTXt, iTXt, eXIf or tIME types while retaining other bytes exactly. Checks CRC/framing and restricted static 8-bit RGB/RGBA headers only. Does not decode IDAT, guarantee valid images, sanitize all metadata, anonymize pixels or guarantee unchanged visual interpretation; EXIF removal may change orientation.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/png-selected-chunks-remove.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Remove explicitly selected PNG text EXIF or time chunks from supplied bytes",
            "Keep PNG critical and unselected ancillary byte ranges unchanged while deleting selected chunk types"
          ],
          "whenToUse": [
            "Need bounded chunk-type removal under a container-framing-only guarantee"
          ],
          "whenNotToUse": [
            "Complete metadata scrubbing, privacy sanitization, anonymization, valid-image certification or guaranteed visual equivalence",
            "JPEG, WebP, HEIC, TIFF, palettes, transparency keys, APNG, interlacing or unsupported PNG headers",
            "Decoding pixels, validating compressed image data, decompressing embedded text or parsing EXIF/ICC semantics",
            "Extracting archives, writing files, uploading, publishing, or changing external state"
          ],
          "capabilities": [
            "Profile png-framed-selected-removal-v1; verify signature, CRCs, first IHDR, contiguous nonempty IDAT and terminal IEND",
            "Retain unselected chunks byte-for-byte and in order; removed audit contains types and offsets only",
            "Unselected ancillary chunks and visible pixels may still carry identifying information; EXIF removal can change interpretation",
            "Deterministic supplied-input-only bytes; no network, clock, randomness or decompression"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "png-framed-selected-removal-v1",
            "decodedInputBytes": 60000,
            "outputPngBytes": 60000,
            "chunks": 128,
            "dimension": 4096,
            "pixels": 1000000,
            "verification": "container-framing-only"
          },
          "related": [
            "content-digest",
            "base64-convert",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "PAYLOAD_LIMIT",
            "DUPLICATE_SELECTION",
            "PNG_SIGNATURE",
            "PNG_CHUNK_LIMIT",
            "PNG_LENGTH",
            "PNG_CHUNK_TYPE",
            "PNG_CRC",
            "PNG_STRUCTURE",
            "PNG_DIMENSIONS",
            "PNG_PROFILE",
            "PNG_CRITICAL_CHUNK"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "data": {
                    "type": "string",
                    "maxLength": 80000
                  },
                  "remove": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "tEXt",
                        "zTXt",
                        "iTXt",
                        "eXIf",
                        "tIME"
                      ]
                    }
                  }
                },
                "required": [
                  "data",
                  "remove"
                ],
                "additionalProperties": false
              },
              "example": {
                "data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADHRFWHRDb21tZW50AGRlbW9ZXIpFAAAADUlEQVR4nGP4z8DwHwAFAAH/iZk9HQAAAABJRU5ErkJggg==",
                "remove": [
                  "tEXt"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "png-selected-chunks-remove",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "encoding": {
                          "type": "string",
                          "const": "base64"
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 80000
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 58,
                          "maximum": 60000
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "width": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 4096
                        },
                        "height": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 4096
                        },
                        "removed": {
                          "maxItems": 125,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "enum": [
                                  "tEXt",
                                  "zTXt",
                                  "iTXt",
                                  "eXIf",
                                  "tIME"
                                ]
                              },
                              "sourceOffset": {
                                "type": "integer",
                                "minimum": 33,
                                "maximum": 60000
                              },
                              "totalBytes": {
                                "type": "integer",
                                "minimum": 12,
                                "maximum": 60000
                              }
                            },
                            "required": [
                              "type",
                              "sourceOffset",
                              "totalBytes"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "preservedChunkTypes": {
                          "minItems": 3,
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z]{2}[A-Z][A-Za-z]$"
                          }
                        },
                        "verification": {
                          "type": "string",
                          "const": "container-framing-only"
                        }
                      },
                      "required": [
                        "encoding",
                        "data",
                        "byteLength",
                        "sha256",
                        "width",
                        "height",
                        "removed",
                        "preservedChunkTypes",
                        "verification"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "png-selected-chunks-remove",
                  "version": "0.29.0",
                  "result": {
                    "encoding": "base64",
                    "data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR4nGP4z8DwHwAFAAH/iZk9HQAAAABJRU5ErkJggg==",
                    "byteLength": 70,
                    "sha256": "4ff6ab670a58c14270e034e2090d9a432caa263a14e0a25785386b0c12f880b5",
                    "width": 1,
                    "height": 1,
                    "removed": [
                      {
                        "type": "tEXt",
                        "sourceOffset": 33,
                        "totalBytes": 24
                      }
                    ],
                    "preservedChunkTypes": [
                      "IHDR",
                      "IDAT",
                      "IEND"
                    ],
                    "verification": "container-framing-only"
                  },
                  "provenance": {
                    "inputSha256": "09b3ae4c431b95bf33334003b3f845cff861c7293f847ce387a817a712dca39e",
                    "outputSha256": "caf9779a8f3189de0fce9ec48e84febb02f0e359afa43910849af830f16df88c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/captions-retime-convert": {
      "post": {
        "operationId": "mpp_captions_retime_convert",
        "summary": "Retime and convert literal captions",
        "description": "Convert a strict plain SRT/WebVTT caption file with caller-supplied rational time scaling and offset, returning canonical caption text and an exact cue timing map.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/captions-retime-convert.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Convert supplied plain SRT subtitles to WebVTT or WebVTT to SRT",
            "Shift subtitle cue times by a known offset or correct constant drift using explicit rational scaling"
          ],
          "whenToUse": [
            "Supplied literal caption text with explicit hour timestamps and a known affine millisecond transform"
          ],
          "whenNotToUse": [
            "Transcription, translation, speaker identification, media access, inferred sync anchors or guaranteed audiovisual alignment",
            "Rich captions, markup, entities, whitespace-only cue lines, cue settings, STYLE, REGION, NOTE or arbitrary WebVTT identifiers",
            "Fetching, uploading, sending, writing files, accessing media or changing external state"
          ],
          "capabilities": [
            "Exact BigInt rational endpoint transformation with one nearest-ties-even millisecond rounding",
            "Canonical LF timestamps and cue indexes, preserved literal text and source/output timing map",
            "Atomic rejection of unsupported grammar, unordered starts, range violations or collapsed durations",
            "Deterministic supplied-input-only inert artifact with no network, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "literal-captions-affine-ms-v1",
            "sourceBytes": 60000,
            "cues": 1000,
            "totalCueTextBytes": 40000,
            "linesPerCue": 20,
            "captionOutputBytes": 100000,
            "maximumTimeMs": 359999999,
            "maximumScalePart": 1000000,
            "scaleRange": "1/1000 through 1000",
            "webvttIds": "all absent or all contiguous numeric 1..N"
          },
          "related": [
            "text-bytes-transcode",
            "zip-store-compose",
            "timestamp-convert"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "CAPTION_SOURCE_LIMIT",
            "CAPTION_SCALE_RANGE",
            "CAPTION_SYNTAX",
            "CAPTION_TEXT_PROFILE",
            "CAPTION_CUE_LIMIT",
            "CAPTION_DURATION",
            "CAPTION_ORDER",
            "CAPTION_TEXT_LIMIT",
            "CAPTION_TIME_RANGE",
            "CAPTION_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "from": {
                    "type": "string",
                    "enum": [
                      "srt",
                      "webvtt"
                    ]
                  },
                  "to": {
                    "type": "string",
                    "enum": [
                      "srt",
                      "webvtt"
                    ]
                  },
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 60000
                  },
                  "timing": {
                    "type": "object",
                    "properties": {
                      "scaleNumerator": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      },
                      "scaleDenominator": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      },
                      "offsetMs": {
                        "type": "integer",
                        "minimum": -359999999,
                        "maximum": 359999999
                      }
                    },
                    "required": [
                      "scaleNumerator",
                      "scaleDenominator",
                      "offsetMs"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "from",
                  "to",
                  "text",
                  "timing"
                ],
                "additionalProperties": false
              },
              "example": {
                "from": "srt",
                "to": "webvtt",
                "text": "1\n00:00:01,000 --> 00:00:02,500\nHello\n\n",
                "timing": {
                  "scaleNumerator": 1,
                  "scaleDenominator": 1,
                  "offsetMs": 250
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "captions-retime-convert",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "format": {
                          "type": "string",
                          "enum": [
                            "srt",
                            "webvtt"
                          ]
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100000
                        },
                        "cues": {
                          "minItems": 1,
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "inputIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 999
                              },
                              "startMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 359999999
                              },
                              "endMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 359999999
                              },
                              "sourceStartMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 359999999
                              },
                              "sourceEndMs": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 359999999
                              }
                            },
                            "required": [
                              "inputIndex",
                              "startMs",
                              "endMs",
                              "sourceStartMs",
                              "sourceEndMs"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "rounding": {
                          "type": "string",
                          "const": "nearest-ties-even"
                        }
                      },
                      "required": [
                        "format",
                        "text",
                        "byteLength",
                        "cues",
                        "rounding"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "captions-retime-convert",
                  "version": "0.29.0",
                  "result": {
                    "format": "webvtt",
                    "text": "WEBVTT\n\n1\n00:00:01.250 --> 00:00:02.750\nHello\n\n",
                    "byteLength": 47,
                    "cues": [
                      {
                        "inputIndex": 0,
                        "startMs": 1250,
                        "endMs": 2750,
                        "sourceStartMs": 1000,
                        "sourceEndMs": 2500
                      }
                    ],
                    "rounding": "nearest-ties-even"
                  },
                  "provenance": {
                    "inputSha256": "86618830933272d3a6509644a192dbec754392cc7a3882ed00cd19de4dc7ce88",
                    "outputSha256": "9963ea0da9e0b915bf16503d12e7c6db4c9cc690b3ec6d64f95b28f9ccc5a2cc",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/fixed-width-records-compose": {
      "post": {
        "operationId": "mpp_fixed_width_records_compose",
        "summary": "Compose UTF-8 byte-column records",
        "description": "Write a real fixed-width UTF-8 import artifact from caller-declared byte columns and string records, with explicit ASCII padding, strict overflow rejection and byte offset manifest.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/fixed-width-records-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Create fixed-width UTF-8 record files with exact byte column positions",
            "Pad string fields to supplied byte widths for a fixed-width importer"
          ],
          "whenToUse": [
            "Explicit UTF-8 byte column layout, ASCII pad characters and exact-key string records"
          ],
          "whenNotToUse": [
            "Terminal display width, glyph alignment, packed decimals, spreadsheet formatting or named bank/government formats",
            "Truncation, numeric coercion, parsing fixed-width input or CSV comparison",
            "Blind transcoding after layout; changing encoding can invalidate UTF-8 byte widths",
            "Fetching, uploading, sending, writing files, accessing media or changing external state"
          ],
          "capabilities": [
            "Exact UTF-8 byte widths, caller-selected left/right ASCII padding and LF/CRLF framing",
            "Ordered records and columns, zero-based end-exclusive per-record column offsets and row byte offsets",
            "Atomic rejection of overflow or mismatched row keys without truncation",
            "Deterministic supplied-input-only inert artifact with no network, clock or randomness"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "utf8-byte-column-records-v1",
            "encoding": "UTF-8",
            "columns": 32,
            "maximumColumnBytes": 256,
            "maximumRecordBytes": 4096,
            "rows": 1000,
            "textOutputBytes": 100000
          },
          "related": [
            "csv-serialize",
            "template-render",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "RECORD_COLUMN_NAME",
            "RECORD_DUPLICATE_COLUMN",
            "RECORD_WIDTH_LIMIT",
            "RECORD_OUTPUT_LIMIT",
            "RECORD_ROW_KEYS",
            "RECORD_TEXT_PROFILE",
            "RECORD_OVERFLOW"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "columns": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "widthBytes": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 256
                        },
                        "align": {
                          "type": "string",
                          "enum": [
                            "left",
                            "right"
                          ]
                        },
                        "pad": {
                          "type": "string",
                          "pattern": "^[\\x20-\\x7e]$"
                        }
                      },
                      "required": [
                        "name",
                        "widthBytes",
                        "align",
                        "pad"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "rows": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "type": "string"
                      }
                    }
                  },
                  "lineEnding": {
                    "type": "string",
                    "enum": [
                      "LF",
                      "CRLF"
                    ]
                  },
                  "finalLineEnding": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "columns",
                  "rows",
                  "lineEnding",
                  "finalLineEnding"
                ],
                "additionalProperties": false
              },
              "example": {
                "columns": [
                  {
                    "name": "code",
                    "widthBytes": 4,
                    "align": "left",
                    "pad": " "
                  },
                  {
                    "name": "qty",
                    "widthBytes": 4,
                    "align": "right",
                    "pad": "0"
                  }
                ],
                "rows": [
                  {
                    "code": "A",
                    "qty": "7"
                  },
                  {
                    "code": "BB",
                    "qty": "42"
                  }
                ],
                "lineEnding": "CRLF",
                "finalLineEnding": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "fixed-width-records-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "recordByteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 4096
                        },
                        "rowByteOffsets": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 100000
                          }
                        },
                        "columns": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              "startByte": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 4095
                              },
                              "endByte": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 4096
                              }
                            },
                            "required": [
                              "name",
                              "startByte",
                              "endByte"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "text",
                        "byteLength",
                        "recordByteLength",
                        "rowByteOffsets",
                        "columns"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "fixed-width-records-compose",
                  "version": "0.29.0",
                  "result": {
                    "text": "A   0007\r\nBB  0042\r\n",
                    "byteLength": 20,
                    "recordByteLength": 8,
                    "rowByteOffsets": [
                      0,
                      10
                    ],
                    "columns": [
                      {
                        "name": "code",
                        "startByte": 0,
                        "endByte": 4
                      },
                      {
                        "name": "qty",
                        "startByte": 4,
                        "endByte": 8
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "6c94e72ed91c6ffdc231e1e577a82ffbc281de0948cc75ebd270a8517d1caa47",
                    "outputSha256": "7f21c0e660c167d123da9877752f336c268d2984b2657754946d028cc92b45a4",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-selector-redact": {
      "post": {
        "operationId": "mpp_json_selector_redact",
        "summary": "Explicit structural JSON redaction",
        "description": "Remove object members or replace selected JSON subtrees with caller-supplied scalars using bounded typed selectors. Original-snapshot matching, expected-count guards and overlap rejection make edits atomic. Optional audit omission; no secret discovery, PII inference, anonymization or safe-to-share guarantee.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-selector-redact.md"
        },
        "x-agent-discovery": {
          "intents": [
            "redact explicit JSON fields across repeated records",
            "remove selected object members with expected match counts",
            "replace structured JSON subtrees with explicit scalar placeholders"
          ],
          "whenToUse": [
            "Caller knows which structural fields must be removed or replaced",
            "Guard a repeated-record cleanup with exact match counts and simultaneous edits"
          ],
          "whenNotToUse": [
            "Discover secrets or infer personal information from meaning",
            "Guarantee anonymity or that remaining data is safe to share",
            "Apply arbitrary JSONPath, regex, recursive descent or scripts",
            "Remove array elements or reorder their identity",
            "Known exact-pointer edits already fit JSON Patch",
            "Read files, send documents, fetch data or change external state"
          ],
          "capabilities": [
            "Declared profile: explicit-structural-redaction-v1",
            "Typed key/index/anyKey/anyIndex selectors with exact own-property matching",
            "Resolve against the original snapshot, guard match counts, reject duplicate and ancestor targets, then clone",
            "Audit contains only caller rule IDs, escaped JSON Pointer paths, action names and counts; includeAudit=false omits both audit and counts",
            "Audit paths/counts and the retained document can expose sensitive structure; callers control replacement values",
            "Deterministic input-only result; no network, clock, randomness, filesystem or runtime dependencies"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "rules": 64,
            "selectorTokens": 20,
            "selectedTargets": 2000,
            "selectorVisits": 250000,
            "profile": "explicit-structural-redaction-v1",
            "ruleIdScalars": 64,
            "selectorIndexMaximum": 9007199254740991
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "DUPLICATE_RULE_ID",
            "INVALID_MATCH_BOUNDS",
            "SELECTOR_VISIT_LIMIT",
            "MATCH_COUNT",
            "TARGET_LIMIT",
            "INVALID_REMOVE_TARGET",
            "TARGET_CONFLICT"
          ],
          "related": [
            "json-patch",
            "pii-redact",
            "json-batch-encode"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "document": {
                    "$ref": "#/paths/~1v1~1mpp~1json-selector-redact/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "rules": {
                    "minItems": 1,
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[\\s\\S]{1,64}(?![\\s\\S])"
                        },
                        "select": {
                          "maxItems": 20,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "key": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "key"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "index": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  }
                                },
                                "required": [
                                  "index"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "anyKey": {
                                    "type": "boolean",
                                    "const": true
                                  }
                                },
                                "required": [
                                  "anyKey"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "anyIndex": {
                                    "type": "boolean",
                                    "const": true
                                  }
                                },
                                "required": [
                                  "anyIndex"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          }
                        },
                        "action": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "replace"
                                },
                                "value": {
                                  "type": [
                                    "string",
                                    "number",
                                    "boolean",
                                    "null"
                                  ]
                                }
                              },
                              "required": [
                                "type",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "remove"
                                }
                              },
                              "required": [
                                "type"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        },
                        "minMatches": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2000
                        },
                        "maxMatches": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2000
                        }
                      },
                      "required": [
                        "id",
                        "select",
                        "action",
                        "minMatches",
                        "maxMatches"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "includeAudit": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "document",
                  "rules"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-selector-redact/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-selector-redact/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "document": {
                  "users": [
                    {
                      "email": "a@example.invalid",
                      "name": "A"
                    },
                    {
                      "email": "b@example.invalid",
                      "name": "B"
                    }
                  ]
                },
                "rules": [
                  {
                    "id": "email",
                    "select": [
                      {
                        "key": "users"
                      },
                      {
                        "anyIndex": true
                      },
                      {
                        "key": "email"
                      }
                    ],
                    "action": {
                      "type": "replace",
                      "value": "[REDACTED]"
                    },
                    "minMatches": 2,
                    "maxMatches": 2
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-selector-redact",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "document": {
                              "$ref": "#/paths/~1v1~1mpp~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            }
                          },
                          "required": [
                            "document"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "document": {
                              "$ref": "#/paths/~1v1~1mpp~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema1"
                            },
                            "audit": {
                              "maxItems": 2000,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "ruleId": {
                                    "type": "string"
                                  },
                                  "path": {
                                    "type": "string"
                                  },
                                  "action": {
                                    "type": "string",
                                    "enum": [
                                      "replace",
                                      "remove"
                                    ]
                                  }
                                },
                                "required": [
                                  "ruleId",
                                  "path",
                                  "action"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "counts": {
                              "minItems": 1,
                              "maxItems": 64,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "ruleId": {
                                    "type": "string"
                                  },
                                  "matches": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 2000
                                  }
                                },
                                "required": [
                                  "ruleId",
                                  "matches"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "document",
                            "audit",
                            "counts"
                          ],
                          "additionalProperties": false
                        }
                      ],
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        },
                        "__schema1": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema1"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-selector-redact/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema1"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-selector-redact",
                  "version": "0.29.0",
                  "result": {
                    "document": {
                      "users": [
                        {
                          "email": "[REDACTED]",
                          "name": "A"
                        },
                        {
                          "email": "[REDACTED]",
                          "name": "B"
                        }
                      ]
                    },
                    "audit": [
                      {
                        "ruleId": "email",
                        "path": "/users/0/email",
                        "action": "replace"
                      },
                      {
                        "ruleId": "email",
                        "path": "/users/1/email",
                        "action": "replace"
                      }
                    ],
                    "counts": [
                      {
                        "ruleId": "email",
                        "matches": 2
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "c13cf62b63cbaafe9d7c6aa847143adc63520cd1abf7abf76ac9b552aa4de723",
                    "outputSha256": "3cb2f0624e5a91719650e702ddc997419a88216846b14e80be844bb1119eb33c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/records-map-transform": {
      "post": {
        "operationId": "mpp_records_map_transform",
        "summary": "Nested record mapping with guarded patches",
        "description": "Construct nested destination records from explicit copy, literal and exact-string lookup rules. Return bounded provenance and optional root-test-guarded RFC 6902 patches. Object destinations only; no implicit coercion, expressions, array expansion, writes or source authenticity checks.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-map-transform.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Adapt records into a nested import schema with provenance",
            "Generate guarded reviewable record migration patches"
          ],
          "whenToUse": [
            "Map supplied records to nested object destinations using a bounded declarative mapping"
          ],
          "whenNotToUse": [
            "Flat field selection only; use records-project",
            "General expressions, recursive array mapping, joins, coercion or redaction",
            "Executing code, writing files, environment changes, network requests, publishing or deployment"
          ],
          "capabilities": [
            "Resolve all sources against the original row; no order-sensitive destination overwrite",
            "Numeric destination segments are object names; source arrays require canonical indexes",
            "Missing-null copy uses default disposition and sourcePresent=false; omitted mappings remain in lineage",
            "Patches include the original source row in a root test and do not authorize a write",
            "Patch modes also pass the released json-patch consumer, including every intermediate-state size/depth/container limit",
            "Aggregate mapped destinations and consumer node/character work have explicit pre-challenge budgets",
            "Complete bounded computation before payment challenge and execution; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "records": 128,
            "rules": 32,
            "pointerDepth": 12,
            "pointerUnits": 1024,
            "lookupPairsPerRule": 64,
            "lookupPairsTotal": 512,
            "patchesPerRow": 100,
            "patchesTotal": 2000,
            "projectedDestinationBytes": 400000,
            "destinationJsonNodes": 12000,
            "patchConsumerNodeWork": 50000,
            "patchConsumerCharacterWork": 5000000,
            "patchConsumerContainerEntries": 1000,
            "patchConsumerJsonNodes": 20000,
            "patchConsumerJsonCharacters": 100000,
            "patchConsumerDepth": 32
          },
          "related": [
            "records-project",
            "json-structural-diff",
            "json-patch",
            "json-batch-encode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_POINTER",
            "POINTER_LIMIT",
            "INVALID_ARRAY_INDEX",
            "DUPLICATE_ID",
            "DUPLICATE_LOOKUP_KEY",
            "LOOKUP_LIMIT",
            "DESTINATION_COLLISION",
            "MISSING_SOURCE",
            "LOOKUP_TYPE",
            "UNKNOWN_LOOKUP_KEY",
            "PATCH_LIMIT",
            "PATCH_COMPOSITION",
            "MAPPING_WORK_LIMIT",
            "PATCH_WORK_LIMIT",
            "ITEM_LIMIT",
            "SIZE_LIMIT",
            "DEPTH_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "rules": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "destination": {
                          "type": "string",
                          "maxLength": 1024
                        },
                        "source": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "copy"
                                },
                                "pointer": {
                                  "type": "string",
                                  "maxLength": 1024
                                },
                                "onMissing": {
                                  "type": "string",
                                  "enum": [
                                    "error",
                                    "omit",
                                    "null"
                                  ]
                                }
                              },
                              "required": [
                                "kind",
                                "pointer",
                                "onMissing"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "literal"
                                },
                                "value": {
                                  "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                                }
                              },
                              "required": [
                                "kind",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "lookup"
                                },
                                "pointer": {
                                  "type": "string",
                                  "maxLength": 1024
                                },
                                "pairs": {
                                  "maxItems": 64,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "key": {
                                        "type": "string"
                                      },
                                      "value": {
                                        "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                                      }
                                    },
                                    "required": [
                                      "key",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "onUnknown": {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "error"
                                        }
                                      },
                                      "required": [
                                        "kind"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "kind": {
                                          "type": "string",
                                          "const": "default"
                                        },
                                        "value": {
                                          "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                                        }
                                      },
                                      "required": [
                                        "kind",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "kind",
                                "pointer",
                                "pairs",
                                "onUnknown"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        }
                      },
                      "required": [
                        "id",
                        "destination",
                        "source"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "records",
                      "guarded-patches",
                      "both"
                    ]
                  }
                },
                "required": [
                  "records",
                  "rules",
                  "mode"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "id": "c7",
                    "display": "Ada",
                    "tier": "pro"
                  }
                ],
                "rules": [
                  {
                    "id": "id",
                    "destination": "/customer/id",
                    "source": {
                      "kind": "copy",
                      "pointer": "/id",
                      "onMissing": "error"
                    }
                  },
                  {
                    "id": "name",
                    "destination": "/customer/name",
                    "source": {
                      "kind": "copy",
                      "pointer": "/display",
                      "onMissing": "error"
                    }
                  },
                  {
                    "id": "plan",
                    "destination": "/plan",
                    "source": {
                      "kind": "lookup",
                      "pointer": "/tier",
                      "pairs": [
                        {
                          "key": "pro",
                          "value": "paid"
                        }
                      ],
                      "onUnknown": {
                        "kind": "error"
                      }
                    }
                  },
                  {
                    "id": "version",
                    "destination": "/apiVersion",
                    "source": {
                      "kind": "literal",
                      "value": 1
                    }
                  }
                ],
                "mode": "both"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-map-transform",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "nested-record-map-v1"
                        },
                        "mode": {
                          "type": "string",
                          "enum": [
                            "records",
                            "guarded-patches",
                            "both"
                          ]
                        },
                        "rows": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "sourceIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "record": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "provenance": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "ruleId": {
                                      "type": "string"
                                    },
                                    "sourcePointer": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    },
                                    "destinationPointer": {
                                      "type": "string"
                                    },
                                    "sourcePresent": {
                                      "type": [
                                        "boolean",
                                        "null"
                                      ]
                                    },
                                    "disposition": {
                                      "type": "string",
                                      "enum": [
                                        "copied",
                                        "literal",
                                        "lookup",
                                        "default",
                                        "omitted"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "ruleId",
                                    "sourcePointer",
                                    "destinationPointer",
                                    "sourcePresent",
                                    "disposition"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "patch": {
                                "anyOf": [
                                  {
                                    "type": "array",
                                    "items": {
                                      "oneOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "op": {
                                              "type": "string",
                                              "const": "test"
                                            },
                                            "path": {
                                              "type": "string",
                                              "const": ""
                                            },
                                            "value": {
                                              "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                            }
                                          },
                                          "required": [
                                            "op",
                                            "path",
                                            "value"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "op": {
                                              "type": "string",
                                              "const": "add"
                                            },
                                            "path": {
                                              "type": "string",
                                              "maxLength": 1024
                                            },
                                            "value": {
                                              "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                            }
                                          },
                                          "required": [
                                            "op",
                                            "path",
                                            "value"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "op": {
                                              "type": "string",
                                              "const": "replace"
                                            },
                                            "path": {
                                              "type": "string",
                                              "maxLength": 1024
                                            },
                                            "value": {
                                              "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                            }
                                          },
                                          "required": [
                                            "op",
                                            "path",
                                            "value"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "object",
                                          "properties": {
                                            "op": {
                                              "type": "string",
                                              "const": "remove"
                                            },
                                            "path": {
                                              "type": "string",
                                              "maxLength": 1024
                                            }
                                          },
                                          "required": [
                                            "op",
                                            "path"
                                          ],
                                          "additionalProperties": false
                                        }
                                      ]
                                    }
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "sourceIndex",
                              "record",
                              "provenance",
                              "patch"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "recordCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "operationCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "mode",
                        "rows",
                        "recordCount",
                        "operationCount",
                        "externalRequests",
                        "execution"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1records-map-transform/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-map-transform",
                  "version": "0.29.0",
                  "result": {
                    "profile": "nested-record-map-v1",
                    "mode": "both",
                    "rows": [
                      {
                        "sourceIndex": 0,
                        "record": {
                          "apiVersion": 1,
                          "customer": {
                            "id": "c7",
                            "name": "Ada"
                          },
                          "plan": "paid"
                        },
                        "provenance": [
                          {
                            "ruleId": "id",
                            "sourcePointer": "/id",
                            "destinationPointer": "/customer/id",
                            "sourcePresent": true,
                            "disposition": "copied"
                          },
                          {
                            "ruleId": "name",
                            "sourcePointer": "/display",
                            "destinationPointer": "/customer/name",
                            "sourcePresent": true,
                            "disposition": "copied"
                          },
                          {
                            "ruleId": "plan",
                            "sourcePointer": "/tier",
                            "destinationPointer": "/plan",
                            "sourcePresent": true,
                            "disposition": "lookup"
                          },
                          {
                            "ruleId": "version",
                            "sourcePointer": null,
                            "destinationPointer": "/apiVersion",
                            "sourcePresent": null,
                            "disposition": "literal"
                          }
                        ],
                        "patch": [
                          {
                            "op": "test",
                            "path": "",
                            "value": {
                              "display": "Ada",
                              "id": "c7",
                              "tier": "pro"
                            }
                          },
                          {
                            "op": "add",
                            "path": "/apiVersion",
                            "value": 1
                          },
                          {
                            "op": "add",
                            "path": "/customer",
                            "value": {
                              "id": "c7",
                              "name": "Ada"
                            }
                          },
                          {
                            "op": "remove",
                            "path": "/display"
                          },
                          {
                            "op": "remove",
                            "path": "/id"
                          },
                          {
                            "op": "add",
                            "path": "/plan",
                            "value": "paid"
                          },
                          {
                            "op": "remove",
                            "path": "/tier"
                          }
                        ]
                      }
                    ],
                    "recordCount": 1,
                    "operationCount": 7,
                    "externalRequests": 0,
                    "execution": false
                  },
                  "provenance": {
                    "inputSha256": "8a4f0c25859630ea88a6e0300b7add71a1a2bf111d562cb9d5293cc61cd85cff",
                    "outputSha256": "6344421da2c94f9751785c5e99bf3febd7bc3fce3d06070bd5777e2b0d7076ee",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/cost-matrix-round": {
      "post": {
        "operationId": "mpp_cost_matrix_round",
        "summary": "Exact two-margin matrix rounding",
        "description": "Round a supplied decimal allocation matrix to exact integer floor/ceiling cells while preserving both declared margins, minimizing absolute error and breaking ties lexicographically; return a verifiable optimum or infeasibility witness. No payments, accounting advice or execution.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/cost-matrix-round.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Round fractional allocations while preserving row and column totals",
            "Reconcile a supplied allocation matrix into integer minor units"
          ],
          "whenToUse": [
            "Caller supplies both exact margins and requires the minimum absolute rounding error"
          ],
          "whenNotToUse": [
            "Actual financial allocation, posting ledgers, payments or accounting advice",
            "Automatically choosing margins or unconstrained proportional apportionment"
          ],
          "capabilities": [
            "Exact decimal BigInt arithmetic with deterministic UTF-16 ID order",
            "Independent residual-potential optimum certificates or bounded infeasibility witnesses",
            "Well-formed infeasible inputs return no usable matrix; pure full evaluation before payment challenge"
          ],
          "related": [
            "integer-apportion",
            "gfm-table-compose"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "rows": 8,
            "columns": 8,
            "cells": 64,
            "decimalIntegerDigits": 18,
            "decimalFractionDigits": 6,
            "targetDigits": 24,
            "vertices": 18,
            "residualArcs": 160,
            "augmentations": 64,
            "maximumRelaxationChecks": 176960
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "MATRIX_DIMENSIONS",
            "MARGIN_TOTAL_MISMATCH",
            "INTERNAL_CERTIFICATE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "rowIds": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  },
                  "columnIds": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  },
                  "values": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 8,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,17})(?:\\.[0-9]{1,6})?$"
                      }
                    }
                  },
                  "rowTargets": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^(?:0|[1-9][0-9]{0,23})$"
                    }
                  },
                  "columnTargets": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^(?:0|[1-9][0-9]{0,23})$"
                    }
                  }
                },
                "required": [
                  "rowIds",
                  "columnIds",
                  "values",
                  "rowTargets",
                  "columnTargets"
                ],
                "additionalProperties": false
              },
              "example": {
                "rowIds": [
                  "r1",
                  "r2"
                ],
                "columnIds": [
                  "a",
                  "b",
                  "c"
                ],
                "values": [
                  [
                    "0.6",
                    "0.6",
                    "0.8"
                  ],
                  [
                    "0.4",
                    "0.4",
                    "0.2"
                  ]
                ],
                "rowTargets": [
                  "2",
                  "1"
                ],
                "columnTargets": [
                  "1",
                  "1",
                  "1"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "cost-matrix-round",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "exact-two-margin-round-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "availabilityVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "rowIds": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "columnIds": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "rowTargets": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "columnTargets": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "optimal"
                            },
                            "matrix": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                }
                              }
                            },
                            "rowTotals": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "columnTotals": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "grandTotal": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "absoluteError": {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "pattern": "^[1-9][0-9]*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            "cells": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "floor": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "fraction": {
                                      "type": "object",
                                      "properties": {
                                        "numerator": {
                                          "type": "string",
                                          "pattern": "^(?:0|[1-9][0-9]*)$"
                                        },
                                        "denominator": {
                                          "type": "string",
                                          "pattern": "^[1-9][0-9]*$"
                                        }
                                      },
                                      "required": [
                                        "numerator",
                                        "denominator"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "increment": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1
                                    }
                                  },
                                  "required": [
                                    "floor",
                                    "fraction",
                                    "increment"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "certificate": {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "min-cost-flow-potentials"
                                },
                                "scale": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "primaryMultiplier": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "combinedCost": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "vertexPotentials": {
                                  "minItems": 4,
                                  "maxItems": 18,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                  }
                                },
                                "requiredFlow": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 64
                                },
                                "achievedFlow": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 64
                                }
                              },
                              "required": [
                                "kind",
                                "scale",
                                "primaryMultiplier",
                                "combinedCost",
                                "vertexPotentials",
                                "requiredFlow",
                                "achievedFlow"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "availabilityVerified",
                            "rowIds",
                            "columnIds",
                            "rowTargets",
                            "columnTargets",
                            "status",
                            "matrix",
                            "rowTotals",
                            "columnTotals",
                            "grandTotal",
                            "absoluteError",
                            "cells",
                            "certificate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "exact-two-margin-round-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "availabilityVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "rowIds": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "columnIds": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "rowTargets": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "columnTargets": {
                              "minItems": 1,
                              "maxItems": 8,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "infeasible"
                            },
                            "matrix": {
                              "type": "null"
                            },
                            "witness": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "margin-bound"
                                    },
                                    "axis": {
                                      "type": "string",
                                      "enum": [
                                        "row",
                                        "column"
                                      ]
                                    },
                                    "id": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 100
                                    },
                                    "target": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "minimum": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "maximum": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "axis",
                                    "id",
                                    "target",
                                    "minimum",
                                    "maximum"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "residual-min-cut"
                                    },
                                    "reachableRowIds": {
                                      "maxItems": 8,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 100
                                      }
                                    },
                                    "reachableColumnIds": {
                                      "maxItems": 8,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 100
                                      }
                                    },
                                    "requiredFlow": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 64
                                    },
                                    "achievedFlow": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 64
                                    },
                                    "cutCapacity": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 64
                                    },
                                    "partialIncrements": {
                                      "minItems": 1,
                                      "maxItems": 8,
                                      "type": "array",
                                      "items": {
                                        "minItems": 1,
                                        "maxItems": 8,
                                        "type": "array",
                                        "items": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 1
                                        }
                                      }
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "reachableRowIds",
                                    "reachableColumnIds",
                                    "requiredFlow",
                                    "achievedFlow",
                                    "cutCapacity",
                                    "partialIncrements"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "availabilityVerified",
                            "rowIds",
                            "columnIds",
                            "rowTargets",
                            "columnTargets",
                            "status",
                            "matrix",
                            "witness"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "cost-matrix-round",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-two-margin-round-v1",
                    "externalRequests": 0,
                    "execution": false,
                    "availabilityVerified": false,
                    "rowIds": [
                      "r1",
                      "r2"
                    ],
                    "columnIds": [
                      "a",
                      "b",
                      "c"
                    ],
                    "rowTargets": [
                      "2",
                      "1"
                    ],
                    "columnTargets": [
                      "1",
                      "1",
                      "1"
                    ],
                    "status": "optimal",
                    "matrix": [
                      [
                        "0",
                        "1",
                        "1"
                      ],
                      [
                        "1",
                        "0",
                        "0"
                      ]
                    ],
                    "rowTotals": [
                      "2",
                      "1"
                    ],
                    "columnTotals": [
                      "1",
                      "1",
                      "1"
                    ],
                    "grandTotal": "3",
                    "absoluteError": {
                      "numerator": "12",
                      "denominator": "5"
                    },
                    "cells": [
                      [
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "3",
                            "denominator": "5"
                          },
                          "increment": 0
                        },
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "3",
                            "denominator": "5"
                          },
                          "increment": 1
                        },
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "4",
                            "denominator": "5"
                          },
                          "increment": 1
                        }
                      ],
                      [
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "2",
                            "denominator": "5"
                          },
                          "increment": 1
                        },
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "2",
                            "denominator": "5"
                          },
                          "increment": 0
                        },
                        {
                          "floor": "0",
                          "fraction": {
                            "numerator": "1",
                            "denominator": "5"
                          },
                          "increment": 0
                        }
                      ]
                    ],
                    "certificate": {
                      "kind": "min-cost-flow-potentials",
                      "scale": "10",
                      "primaryMultiplier": "64",
                      "combinedCost": "1564",
                      "vertexPotentials": [
                        "-772",
                        "-530",
                        "-772",
                        "0",
                        "-2",
                        "0",
                        "0"
                      ],
                      "requiredFlow": 3,
                      "achievedFlow": 3
                    }
                  },
                  "provenance": {
                    "inputSha256": "15594a17c74c1a6c9b7cd6f0f74ea731fd6a8c6a10f59eab883541f893d56dfa",
                    "outputSha256": "ac4a933060b7d1d3b3d7d2bb32f7a9a4ef7ba15111ac766bb16a59be2976ee2a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/assignment-cost-optimize": {
      "post": {
        "operationId": "mpp_assignment_cost_optimize",
        "summary": "Exact fixed-slot cost assignment",
        "description": "Choose an exact minimum-cost complete one-job-per-slot assignment over caller-declared nonoverlapping slots and admissible edges, with lexical ties and a verifiable optimum or Hall-deficiency certificate. No live availability check, reservation or job dispatch.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/assignment-cost-optimize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Assign independent jobs to fixed slots at minimum total cost",
            "Optimize exact one-to-one job and slot pairing with forbidden assignments"
          ],
          "whenToUse": [
            "Caller declares all admissible edges and pairwise nonoverlapping slots in one time coordinate system"
          ],
          "whenNotToUse": [
            "General precedence or resource scheduling, overlapping slots, travel-time or skill inference",
            "Live calendar availability, slot reservation, real job dispatch, payments or currency conversion"
          ],
          "capabilities": [
            "Exact decimal BigInt optimization with lexical slot-ID ties in sorted job order",
            "Complete assignments and start-ordered inert schedules with residual-potential optimum certificates",
            "Maximum cardinality and a Hall-deficient job-set witness when no complete schedule exists",
            "Pure full evaluation before payment challenge; valid infeasible results contain no usable schedule"
          ],
          "related": [
            "workflow-resource-plan",
            "interval-analyze"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "jobs": 16,
            "slots": 32,
            "edges": 512,
            "tickMaximum": 1000000000000,
            "decimalIntegerDigits": 12,
            "decimalFractionDigits": 6,
            "vertices": 50,
            "residualArcs": 1120,
            "augmentations": 16,
            "maximumVertexSelectionChecks": 40000,
            "maximumEdgeRelaxationChecks": 17920
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ID",
            "INVALID_SLOT",
            "OVERLAPPING_SLOTS",
            "UNKNOWN_EDGE_ID",
            "DUPLICATE_EDGE",
            "INTERNAL_CERTIFICATE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "jobIds": {
                    "minItems": 1,
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  },
                  "slots": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "start": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000000
                        },
                        "end": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000000
                        }
                      },
                      "required": [
                        "id",
                        "start",
                        "end"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "edges": {
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "jobId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "slotId": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "cost": {
                          "type": "string",
                          "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                        }
                      },
                      "required": [
                        "jobId",
                        "slotId",
                        "cost"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "timeUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "timeOrigin": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "costUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  }
                },
                "required": [
                  "jobIds",
                  "slots",
                  "edges",
                  "timeUnit",
                  "timeOrigin",
                  "costUnit"
                ],
                "additionalProperties": false
              },
              "example": {
                "jobIds": [
                  "a",
                  "b",
                  "c"
                ],
                "slots": [
                  {
                    "id": "s1",
                    "start": 0,
                    "end": 10
                  },
                  {
                    "id": "s2",
                    "start": 10,
                    "end": 20
                  },
                  {
                    "id": "s3",
                    "start": 20,
                    "end": 30
                  }
                ],
                "edges": [
                  {
                    "jobId": "a",
                    "slotId": "s1",
                    "cost": "7"
                  },
                  {
                    "jobId": "a",
                    "slotId": "s2",
                    "cost": "1"
                  },
                  {
                    "jobId": "a",
                    "slotId": "s3",
                    "cost": "4"
                  },
                  {
                    "jobId": "b",
                    "slotId": "s1",
                    "cost": "2"
                  },
                  {
                    "jobId": "b",
                    "slotId": "s2",
                    "cost": "6"
                  },
                  {
                    "jobId": "b",
                    "slotId": "s3",
                    "cost": "5"
                  },
                  {
                    "jobId": "c",
                    "slotId": "s1",
                    "cost": "3"
                  },
                  {
                    "jobId": "c",
                    "slotId": "s2",
                    "cost": "4"
                  },
                  {
                    "jobId": "c",
                    "slotId": "s3",
                    "cost": "1"
                  }
                ],
                "timeUnit": "minute",
                "timeOrigin": "caller-defined zero",
                "costUnit": "model cost units"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "assignment-cost-optimize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "fixed-slot-exact-assignment-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "availabilityVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "timeUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "timeOrigin": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "costUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "jobIds": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "slotIds": {
                              "minItems": 1,
                              "maxItems": 32,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "optimal"
                            },
                            "assignments": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "jobId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "slotId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "start": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000000000000
                                  },
                                  "end": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000000000000
                                  },
                                  "cost": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                                  }
                                },
                                "required": [
                                  "jobId",
                                  "slotId",
                                  "start",
                                  "end",
                                  "cost"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "schedule": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "jobId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "slotId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  },
                                  "start": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000000000000
                                  },
                                  "end": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000000000000
                                  },
                                  "cost": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                                  }
                                },
                                "required": [
                                  "jobId",
                                  "slotId",
                                  "start",
                                  "end",
                                  "cost"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "unusedSlotIds": {
                              "maxItems": 31,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "totalCost": {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "pattern": "^[1-9][0-9]*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            "certificate": {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "min-cost-flow-potentials"
                                },
                                "scale": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "primaryMultiplier": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "tieBase": {
                                  "type": "integer",
                                  "minimum": 2,
                                  "maximum": 33
                                },
                                "combinedCost": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "vertexPotentials": {
                                  "minItems": 4,
                                  "maxItems": 50,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                  }
                                },
                                "requiredFlow": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 16
                                },
                                "achievedFlow": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 16
                                }
                              },
                              "required": [
                                "kind",
                                "scale",
                                "primaryMultiplier",
                                "tieBase",
                                "combinedCost",
                                "vertexPotentials",
                                "requiredFlow",
                                "achievedFlow"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "availabilityVerified",
                            "timeUnit",
                            "timeOrigin",
                            "costUnit",
                            "jobIds",
                            "slotIds",
                            "status",
                            "assignments",
                            "schedule",
                            "unusedSlotIds",
                            "totalCost",
                            "certificate"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "fixed-slot-exact-assignment-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "availabilityVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "timeUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "timeOrigin": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "costUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 100
                            },
                            "jobIds": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "slotIds": {
                              "minItems": 1,
                              "maxItems": 32,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "infeasible"
                            },
                            "schedule": {
                              "type": "null"
                            },
                            "maximumCardinality": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 15
                            },
                            "witness": {
                              "type": "object",
                              "properties": {
                                "kind": {
                                  "type": "string",
                                  "const": "hall-deficiency"
                                },
                                "jobIds": {
                                  "minItems": 1,
                                  "maxItems": 16,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  }
                                },
                                "neighborSlotIds": {
                                  "maxItems": 32,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 100
                                  }
                                },
                                "deficiency": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 16
                                },
                                "maximumMatching": {
                                  "maxItems": 15,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "jobId": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 100
                                      },
                                      "slotId": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 100
                                      }
                                    },
                                    "required": [
                                      "jobId",
                                      "slotId"
                                    ],
                                    "additionalProperties": false
                                  }
                                }
                              },
                              "required": [
                                "kind",
                                "jobIds",
                                "neighborSlotIds",
                                "deficiency",
                                "maximumMatching"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "availabilityVerified",
                            "timeUnit",
                            "timeOrigin",
                            "costUnit",
                            "jobIds",
                            "slotIds",
                            "status",
                            "schedule",
                            "maximumCardinality",
                            "witness"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "assignment-cost-optimize",
                  "version": "0.29.0",
                  "result": {
                    "profile": "fixed-slot-exact-assignment-v1",
                    "externalRequests": 0,
                    "execution": false,
                    "availabilityVerified": false,
                    "timeUnit": "minute",
                    "timeOrigin": "caller-defined zero",
                    "costUnit": "model cost units",
                    "jobIds": [
                      "a",
                      "b",
                      "c"
                    ],
                    "slotIds": [
                      "s1",
                      "s2",
                      "s3"
                    ],
                    "status": "optimal",
                    "assignments": [
                      {
                        "jobId": "a",
                        "slotId": "s2",
                        "start": 10,
                        "end": 20,
                        "cost": "1"
                      },
                      {
                        "jobId": "b",
                        "slotId": "s1",
                        "start": 0,
                        "end": 10,
                        "cost": "2"
                      },
                      {
                        "jobId": "c",
                        "slotId": "s3",
                        "start": 20,
                        "end": 30,
                        "cost": "1"
                      }
                    ],
                    "schedule": [
                      {
                        "jobId": "b",
                        "slotId": "s1",
                        "start": 0,
                        "end": 10,
                        "cost": "2"
                      },
                      {
                        "jobId": "a",
                        "slotId": "s2",
                        "start": 10,
                        "end": 20,
                        "cost": "1"
                      },
                      {
                        "jobId": "c",
                        "slotId": "s3",
                        "start": 20,
                        "end": 30,
                        "cost": "1"
                      }
                    ],
                    "unusedSlotIds": [],
                    "totalCost": {
                      "numerator": "4",
                      "denominator": "1"
                    },
                    "certificate": {
                      "kind": "min-cost-flow-potentials",
                      "scale": "1",
                      "primaryMultiplier": "64",
                      "tieBase": 4,
                      "combinedCost": "274",
                      "vertexPotentials": [
                        "0",
                        "48",
                        "0",
                        "62",
                        "128",
                        "128",
                        "128",
                        "128"
                      ],
                      "requiredFlow": 3,
                      "achievedFlow": 3
                    }
                  },
                  "provenance": {
                    "inputSha256": "f9e5201837d942fee4208f1463702123eb7efe360904719bc8393f0680cdfd7f",
                    "outputSha256": "e078060ea2c9b79dfff96c4e2bcff3a77cd038736ab4285f0d4d4561e1e2065f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/merkle-bundle-compose": {
      "post": {
        "operationId": "mpp_merkle_bundle_compose",
        "summary": "Count-bound Merkle artifact bundle",
        "description": "Compose a local SHA-256 Merkle content commitment binding exact IDs, bytes and item count, plus selected shape-aware inclusion paths. This is consistency with a separately trusted root, not identity, signature, authenticity, confidentiality, completeness, timestamp or file-safety verification.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/merkle-bundle-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Commit an artifact bundle to one count-bound content root",
            "Produce selective inclusion proofs for supplied artifact bytes"
          ],
          "whenToUse": [
            "Hand off one supplied artifact and its logarithmic inclusion path without resending the full bundle"
          ],
          "whenNotToUse": [
            "Signatures, certificate transparency, blockchain protocol compatibility, append-only proofs or trusted root distribution",
            "Authentication, identity, confidentiality, timestamping, safety or complete-item-list verification",
            "Executing code, writing files, environment changes, network requests, publishing or deployment"
          ],
          "capabilities": [
            "Domain bytes 00 for framed leaves, 01 for internal pairs and 02 for count-bound public root",
            "Exact UTF-16 ID sorting; canonical base64 and UTF-8 equivalence",
            "Greatest-power-of-two split without leaf duplication; cached tree, bottom-up sibling orientation",
            "Verifier must validate index, count and exact expected proof shape; hashes do not anonymize low-entropy content",
            "Complete bounded computation before payment challenge and execution; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "items": 128,
            "proofs": 128,
            "idUnits": 100,
            "decodedBytes": 60000,
            "treeNodes": 255,
            "hashCalls": 256,
            "proofSiblings": 7
          },
          "related": [
            "content-digest",
            "artifact-manifest-check",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_BASE64",
            "DUPLICATE_ID",
            "DUPLICATE_PROOF_ID",
            "UNKNOWN_PROOF_ID",
            "PAYLOAD_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "items": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "encoding": {
                          "type": "string",
                          "enum": [
                            "utf8",
                            "base64"
                          ]
                        },
                        "data": {
                          "type": "string",
                          "maxLength": 90000
                        }
                      },
                      "required": [
                        "id",
                        "encoding",
                        "data"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "proofIds": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  }
                },
                "required": [
                  "items",
                  "proofIds"
                ],
                "additionalProperties": false
              },
              "example": {
                "items": [
                  {
                    "id": "a",
                    "encoding": "utf8",
                    "data": "A"
                  },
                  {
                    "id": "b",
                    "encoding": "utf8",
                    "data": "B"
                  },
                  {
                    "id": "c",
                    "encoding": "base64",
                    "data": "AP8="
                  }
                ],
                "proofIds": [
                  "a"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "merkle-bundle-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "id-bytes-merkle-sha256-v1"
                        },
                        "root": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "treeHash": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "itemCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 128
                        },
                        "manifest": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "byteLength": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "leafHash": {
                                "type": "string",
                                "pattern": "^[a-f0-9]{64}$"
                              }
                            },
                            "required": [
                              "id",
                              "index",
                              "byteLength",
                              "leafHash"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "proofs": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 100
                              },
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "itemCount": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 128
                              },
                              "siblings": {
                                "maxItems": 7,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "side": {
                                      "type": "string",
                                      "enum": [
                                        "left",
                                        "right"
                                      ]
                                    },
                                    "hash": {
                                      "type": "string",
                                      "pattern": "^[a-f0-9]{64}$"
                                    }
                                  },
                                  "required": [
                                    "side",
                                    "hash"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "id",
                              "index",
                              "itemCount",
                              "siblings"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "authenticityVerified": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "root",
                        "treeHash",
                        "itemCount",
                        "manifest",
                        "proofs",
                        "externalRequests",
                        "authenticityVerified"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "merkle-bundle-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "id-bytes-merkle-sha256-v1",
                    "root": "4f60c66aed8c8da2fe90771108c10a02951b380ab0c0e5b515c619cc0a8f1d9d",
                    "treeHash": "d85a25d6b37e6f85dd8eee6489845d06e42c8df14567ca344a8bd833524c6c03",
                    "itemCount": 3,
                    "manifest": [
                      {
                        "id": "a",
                        "index": 0,
                        "byteLength": 1,
                        "leafHash": "728d8462eee330125f9b80cc67dabc50d2b19be470f4e0db6dae1db8479fd68e"
                      },
                      {
                        "id": "b",
                        "index": 1,
                        "byteLength": 1,
                        "leafHash": "0b17a04d58081b5d3fbbf2b58e132ca9857cb7a806d8b6590df3c498a4e717e3"
                      },
                      {
                        "id": "c",
                        "index": 2,
                        "byteLength": 2,
                        "leafHash": "896c085e5286e008c46dc1219c9508f2f575f0dd667a48af63f8efdcda36fc31"
                      }
                    ],
                    "proofs": [
                      {
                        "id": "a",
                        "index": 0,
                        "itemCount": 3,
                        "siblings": [
                          {
                            "side": "right",
                            "hash": "0b17a04d58081b5d3fbbf2b58e132ca9857cb7a806d8b6590df3c498a4e717e3"
                          },
                          {
                            "side": "right",
                            "hash": "896c085e5286e008c46dc1219c9508f2f575f0dd667a48af63f8efdcda36fc31"
                          }
                        ]
                      }
                    ],
                    "externalRequests": 0,
                    "authenticityVerified": false
                  },
                  "provenance": {
                    "inputSha256": "589ef52b234d843c25226c2fcfa453e7a2980ec2b03514bb6c26acdf277db550",
                    "outputSha256": "5d213c82d85b14afdd8492030f41aae579136720b2567ff6fb1577714478bca4",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/env-example-compose": {
      "post": {
        "operationId": "mpp_env_example_compose",
        "summary": "Names-only secret dotenv example",
        "description": "Compose a deterministic literal .env.example and unresolved-variable checklist from explicit public and names-only secret declarations. Secret declarations accept no value/default field. Names-only secret declarations; public values supplied by the caller. No secret detection, secret-free certification, environment reads or changes.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/env-example-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate an env example file with names-only secret placeholders",
            "Produce an unresolved configuration-variable checklist"
          ],
          "whenToUse": [
            "Compile explicit declarations into a deterministic dotenv example with literal public defaults"
          ],
          "whenNotToUse": [
            "Secret scanning, secret-free certification, retrieving credentials or classifying whether caller public values contain secrets",
            "Shell sourcing, escape syntax, variable interpolation, production configuration or environment mutation",
            "Executing code, writing files, environment changes, network requests, publishing or deployment"
          ],
          "capabilities": [
            "Public defaults use single quotes; prohibited characters are rejected rather than escaped",
            "Secret declarations have no accepted default or value field; unresolved variables are comment-only",
            "Names-only secret declarations; public values supplied by the caller.",
            "Required and optional unresolved names and sorted declaration manifest; exact UTF-8 text length",
            "Complete bounded computation before payment challenge and execution; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "variables": 128,
            "nameUnits": 64,
            "descriptionUnits": 256,
            "defaultBytes": 2048,
            "textBytes": 100000
          },
          "related": [
            "template-render",
            "merkle-bundle-compose",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_NAME",
            "INVALID_DESCRIPTION",
            "INVALID_LITERAL",
            "DEFAULT_LIMIT",
            "TEXT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "variables": {
                    "minItems": 1,
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "public"
                            },
                            "required": {
                              "type": "boolean"
                            },
                            "description": {
                              "type": "string",
                              "maxLength": 256
                            },
                            "default": {
                              "type": "string",
                              "maxLength": 2048
                            }
                          },
                          "required": [
                            "name",
                            "kind",
                            "required"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "secret"
                            },
                            "required": {
                              "type": "boolean"
                            },
                            "description": {
                              "type": "string",
                              "maxLength": 256
                            }
                          },
                          "required": [
                            "name",
                            "kind",
                            "required"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "variables"
                ],
                "additionalProperties": false
              },
              "example": {
                "variables": [
                  {
                    "name": "API_BASE",
                    "kind": "public",
                    "required": true,
                    "default": "https://example.invalid/v1"
                  },
                  {
                    "name": "API_KEY",
                    "kind": "secret",
                    "required": true
                  },
                  {
                    "name": "DEBUG",
                    "kind": "public",
                    "required": false,
                    "default": "false"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "env-example-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "dotenv-literal-example-v1"
                        },
                        "text": {
                          "type": "string"
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "declaredSecretNames": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                          }
                        },
                        "requiredWithoutDefaults": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                          }
                        },
                        "optionalWithoutDefaults": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                          }
                        },
                        "manifest": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "pattern": "^[A-Z_][A-Z0-9_]{0,63}$"
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "public",
                                  "secret"
                                ]
                              },
                              "required": {
                                "type": "boolean"
                              },
                              "hasDefault": {
                                "type": "boolean"
                              },
                              "description": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "kind",
                              "required",
                              "hasDefault",
                              "description"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "classification": {
                          "type": "string",
                          "const": "Names-only secret declarations; public values supplied by the caller."
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "environmentChanged": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "text",
                        "byteLength",
                        "declaredSecretNames",
                        "requiredWithoutDefaults",
                        "optionalWithoutDefaults",
                        "manifest",
                        "classification",
                        "externalRequests",
                        "environmentChanged"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "env-example-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "dotenv-literal-example-v1",
                    "text": "API_BASE='https://example.invalid/v1'\n# Required secret: API_KEY\nDEBUG='false'\n",
                    "byteLength": 79,
                    "declaredSecretNames": [
                      "API_KEY"
                    ],
                    "requiredWithoutDefaults": [
                      "API_KEY"
                    ],
                    "optionalWithoutDefaults": [],
                    "manifest": [
                      {
                        "name": "API_BASE",
                        "kind": "public",
                        "required": true,
                        "hasDefault": true,
                        "description": null
                      },
                      {
                        "name": "API_KEY",
                        "kind": "secret",
                        "required": true,
                        "hasDefault": false,
                        "description": null
                      },
                      {
                        "name": "DEBUG",
                        "kind": "public",
                        "required": false,
                        "hasDefault": true,
                        "description": null
                      }
                    ],
                    "classification": "Names-only secret declarations; public values supplied by the caller.",
                    "externalRequests": 0,
                    "environmentChanged": false
                  },
                  "provenance": {
                    "inputSha256": "53598ba3cbc88dca06116cd5d2e1aee89d6e21bfee339ed11bb4bf77ea3b654f",
                    "outputSha256": "58044952de5e7a5301a62a40a7f0804e8c887d429e45436c16002485fa32d136",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/availability-slots-compose": {
      "post": {
        "operationId": "mpp_availability_slots_compose",
        "summary": "Supplied-calendar availability slot composer",
        "description": "Compose all grid-aligned candidate meetings with whole-slot attendee continuity, required participants and explicit meeting buffers from supplied available/busy intervals.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/availability-slots-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "find candidate meeting slots from supplied calendars",
            "enumerate whole-meeting attendee availability",
            "compose buffered quorum meeting candidates"
          ],
          "whenToUse": [
            "find candidate meeting slots from supplied calendars",
            "enumerate whole-meeting attendee availability",
            "compose buffered quorum meeting candidates"
          ],
          "whenNotToUse": [
            "Live account access, invitations, booking or authenticating external observations",
            "Aggregate concurrency without the same attendees available for the entire meeting",
            "Ranked preferences, scheduling optimization or a conflict-free set of meetings",
            "Accessing calendars, scheduling jobs, reserving meetings, network requests or external state changes"
          ],
          "capabilities": [
            "Half-open intervals; union available and busy separately, subtract busy, then fit each attendee's protected meeting span; supplied availability is not verified",
            "Buffers may extend outside search window only within supplied free intervals",
            "Explicit grid origin permits negative conceptual grid indices; sorted complete attendee lists and all eligible candidates",
            "Caller-supplied data only; no current clock, randomness, environment or timezone-database reads",
            "Complete bounded validation before payment challenge; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "supplied-calendar-grid-v1",
            "participants": 32,
            "intervals": 512,
            "endpointTicks": 1000000000000,
            "windowTicks": 1000000000,
            "durationStepBufferTicks": 1000000000,
            "consideredStarts": 4096,
            "slots": 1024,
            "primitiveComparisons": 1000000,
            "labelCodeUnits": 128
          },
          "related": [
            "interval-analyze",
            "icalendar-compose",
            "assignment-cost-optimize"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INTERVAL",
            "INVALID_WINDOW",
            "INVALID_ATTENDEE_COUNT",
            "DUPLICATE_ID"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "window": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000000000
                      },
                      "end": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000000000
                      }
                    },
                    "required": [
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  },
                  "duration": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000000
                  },
                  "step": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000000
                  },
                  "gridOrigin": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000000000
                  },
                  "unit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "minimumAttendees": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 32
                  },
                  "participants": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64,
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                        },
                        "required": {
                          "type": "boolean"
                        },
                        "available": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "busy": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              }
                            },
                            "required": [
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "bufferBefore": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000
                        },
                        "bufferAfter": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000000
                        }
                      },
                      "required": [
                        "id",
                        "required",
                        "available",
                        "busy",
                        "bufferBefore",
                        "bufferAfter"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "window",
                  "duration",
                  "step",
                  "gridOrigin",
                  "unit",
                  "minimumAttendees",
                  "participants"
                ],
                "additionalProperties": false
              },
              "example": {
                "window": {
                  "start": 0,
                  "end": 120
                },
                "duration": 30,
                "step": 15,
                "gridOrigin": 0,
                "unit": "minutes-from-supplied-origin",
                "minimumAttendees": 2,
                "participants": [
                  {
                    "id": "A",
                    "required": true,
                    "available": [
                      {
                        "start": 0,
                        "end": 120
                      }
                    ],
                    "busy": [
                      {
                        "start": 30,
                        "end": 45
                      }
                    ],
                    "bufferBefore": 0,
                    "bufferAfter": 0
                  },
                  {
                    "id": "B",
                    "required": false,
                    "available": [
                      {
                        "start": 15,
                        "end": 90
                      }
                    ],
                    "busy": [],
                    "bufferBefore": 0,
                    "bufferAfter": 0
                  },
                  {
                    "id": "C",
                    "required": false,
                    "available": [
                      {
                        "start": 60,
                        "end": 120
                      }
                    ],
                    "busy": [],
                    "bufferBefore": 0,
                    "bufferAfter": 0
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "availability-slots-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "supplied-calendar-grid-v1"
                        },
                        "unit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "consideredStarts": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 4096
                        },
                        "slots": {
                          "maxItems": 1024,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "attendeeIds": {
                                "minItems": 1,
                                "maxItems": 32,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64,
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                                }
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "attendeeIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "complete": {
                          "type": "boolean",
                          "const": true
                        },
                        "availabilityVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "unit",
                        "consideredStarts",
                        "slots",
                        "complete",
                        "availabilityVerified",
                        "execution"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "availability-slots-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "supplied-calendar-grid-v1",
                    "unit": "minutes-from-supplied-origin",
                    "consideredStarts": 7,
                    "slots": [
                      {
                        "start": 45,
                        "end": 75,
                        "attendeeIds": [
                          "A",
                          "B"
                        ]
                      },
                      {
                        "start": 60,
                        "end": 90,
                        "attendeeIds": [
                          "A",
                          "B",
                          "C"
                        ]
                      },
                      {
                        "start": 75,
                        "end": 105,
                        "attendeeIds": [
                          "A",
                          "C"
                        ]
                      },
                      {
                        "start": 90,
                        "end": 120,
                        "attendeeIds": [
                          "A",
                          "C"
                        ]
                      }
                    ],
                    "complete": true,
                    "availabilityVerified": false,
                    "execution": false
                  },
                  "provenance": {
                    "inputSha256": "7ae7ef63263d7ff8b510767d3a8eea50e01fc39c9dab15988e2379a3f92c8c6a",
                    "outputSha256": "347105516dc56b43ed286eab482e138976e52026adfba297f7c6d7433921d895",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/time-series-grid-compose": {
      "post": {
        "operationId": "mpp_time_series_grid_compose",
        "summary": "Exact supported time-series grid composer",
        "description": "Compose an aligned grid from supplied nonoverlapping piecewise-constant segments with exact rational integrals, means over supplied support and source contribution durations.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/time-series-grid-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "resample piecewise-constant time series to an exact aligned grid",
            "calculate time-weighted means over explicit supplied support",
            "compose exact rational series cells with missing-support evidence"
          ],
          "whenToUse": [
            "resample piecewise-constant time series to an exact aligned grid",
            "calculate time-weighted means over explicit supplied support",
            "compose exact rational series cells with missing-support evidence"
          ],
          "whenNotToUse": [
            "Interpolation, zero filling, extrapolation or last-observation carry-forward",
            "Overlapping segments within one series or undeclared measurement validity",
            "Floating-point approximations, display rounding or inference of observation quality",
            "Accessing calendars, scheduling jobs, reserving meetings, network requests or external state changes"
          ],
          "capabilities": [
            "Exact reduced rational value-times-ticks integrals and support-only means; zero support yields null mean",
            "Per-cell support completeness and sorted source-duration contributions; complete result does not imply complete data support",
            "Canonical shortest signed decimal values: up to 12 integer digits and 6 fractional digits; no negative zero or trailing fractional zeros",
            "Nonoverlapping sources are clipped to the grid; empty series is valid and source order is irrelevant",
            "Caller-supplied data only; no current clock, randomness, environment or timezone-database reads",
            "Complete bounded validation before payment challenge; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "explicit-support-grid-v1",
            "series": 8,
            "segments": 1000,
            "cellsPerSeries": 256,
            "aggregateCells": 512,
            "contributions": 2000,
            "endpointTicks": 1000000000000,
            "valueIntegerDigits": 12,
            "valueFractionalDigits": 6,
            "labelCodeUnits": 128
          },
          "related": [
            "time-series-inspect",
            "records-aggregate",
            "decimal-distribution-summarize"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INTERVAL",
            "INVALID_GRID",
            "OVERLAPPING_SEGMENTS",
            "DUPLICATE_ID"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "window": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000000000
                      },
                      "end": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000000000
                      }
                    },
                    "required": [
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  },
                  "step": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000000000000
                  },
                  "timeUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "valueUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "series": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64,
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                        },
                        "segments": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64,
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000000000
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 20,
                                "pattern": "^(?!-0$)-?(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{0,5}[1-9])?$"
                              }
                            },
                            "required": [
                              "id",
                              "start",
                              "end",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "segments"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "window",
                  "step",
                  "timeUnit",
                  "valueUnit",
                  "series"
                ],
                "additionalProperties": false
              },
              "example": {
                "window": {
                  "start": 0,
                  "end": 12
                },
                "step": 4,
                "timeUnit": "seconds",
                "valueUnit": "requests-per-second",
                "series": [
                  {
                    "id": "load",
                    "segments": [
                      {
                        "id": "a",
                        "start": 0,
                        "end": 3,
                        "value": "2"
                      },
                      {
                        "id": "b",
                        "start": 3,
                        "end": 7,
                        "value": "4"
                      },
                      {
                        "id": "c",
                        "start": 9,
                        "end": 12,
                        "value": "1"
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "time-series-grid-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "explicit-support-grid-v1"
                        },
                        "timeUnit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "valueUnit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "series": {
                          "minItems": 1,
                          "maxItems": 8,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64,
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                              },
                              "cells": {
                                "minItems": 1,
                                "maxItems": 256,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "start": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000000000000
                                    },
                                    "end": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000000000000
                                    },
                                    "supportedTicks": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000000000000
                                    },
                                    "integral": {
                                      "type": "object",
                                      "properties": {
                                        "numerator": {
                                          "type": "string",
                                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                        },
                                        "denominator": {
                                          "type": "string",
                                          "pattern": "^[1-9][0-9]*$"
                                        }
                                      },
                                      "required": [
                                        "numerator",
                                        "denominator"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "meanOverSupport": {
                                      "anyOf": [
                                        {
                                          "type": "object",
                                          "properties": {
                                            "numerator": {
                                              "type": "string",
                                              "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                            },
                                            "denominator": {
                                              "type": "string",
                                              "pattern": "^[1-9][0-9]*$"
                                            }
                                          },
                                          "required": [
                                            "numerator",
                                            "denominator"
                                          ],
                                          "additionalProperties": false
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    },
                                    "completeSupport": {
                                      "type": "boolean"
                                    },
                                    "contributions": {
                                      "maxItems": 1000,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "segmentId": {
                                            "type": "string",
                                            "minLength": 1,
                                            "maxLength": 64,
                                            "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
                                          },
                                          "ticks": {
                                            "type": "integer",
                                            "minimum": 1,
                                            "maximum": 1000000000000
                                          }
                                        },
                                        "required": [
                                          "segmentId",
                                          "ticks"
                                        ],
                                        "additionalProperties": false
                                      }
                                    }
                                  },
                                  "required": [
                                    "start",
                                    "end",
                                    "supportedTicks",
                                    "integral",
                                    "meanOverSupport",
                                    "completeSupport",
                                    "contributions"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "id",
                              "cells"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "complete": {
                          "type": "boolean",
                          "const": true
                        }
                      },
                      "required": [
                        "profile",
                        "timeUnit",
                        "valueUnit",
                        "series",
                        "complete"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "time-series-grid-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-support-grid-v1",
                    "timeUnit": "seconds",
                    "valueUnit": "requests-per-second",
                    "series": [
                      {
                        "id": "load",
                        "cells": [
                          {
                            "start": 0,
                            "end": 4,
                            "supportedTicks": 4,
                            "integral": {
                              "numerator": "10",
                              "denominator": "1"
                            },
                            "meanOverSupport": {
                              "numerator": "5",
                              "denominator": "2"
                            },
                            "completeSupport": true,
                            "contributions": [
                              {
                                "segmentId": "a",
                                "ticks": 3
                              },
                              {
                                "segmentId": "b",
                                "ticks": 1
                              }
                            ]
                          },
                          {
                            "start": 4,
                            "end": 8,
                            "supportedTicks": 3,
                            "integral": {
                              "numerator": "12",
                              "denominator": "1"
                            },
                            "meanOverSupport": {
                              "numerator": "4",
                              "denominator": "1"
                            },
                            "completeSupport": false,
                            "contributions": [
                              {
                                "segmentId": "b",
                                "ticks": 3
                              }
                            ]
                          },
                          {
                            "start": 8,
                            "end": 12,
                            "supportedTicks": 3,
                            "integral": {
                              "numerator": "3",
                              "denominator": "1"
                            },
                            "meanOverSupport": {
                              "numerator": "1",
                              "denominator": "1"
                            },
                            "completeSupport": false,
                            "contributions": [
                              {
                                "segmentId": "c",
                                "ticks": 3
                              }
                            ]
                          }
                        ]
                      }
                    ],
                    "complete": true
                  },
                  "provenance": {
                    "inputSha256": "aca420f4b753b855599d4f1fbe71cbae95db8b4c354530674f361c412b0151a1",
                    "outputSha256": "8fd5e070be522a17b80a4916857c16ce588d5cd527fa2c39465dd7b00dfe31f1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/cron-occurrences-expand": {
      "post": {
        "operationId": "mpp_cron_occurrences_expand",
        "summary": "Supplied-offset cron occurrence expander",
        "description": "Expand bounded five-field cron into complete UTC occurrences using an exact caller-supplied offset timeline, including every fold instant and no nonexistent gap minute.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/cron-occurrences-expand.md"
        },
        "x-agent-discovery": {
          "intents": [
            "expand cron occurrences in a supplied UTC window",
            "enumerate fixed-offset or UTC cron schedules offline",
            "inspect cron gap and fold matches against supplied offset periods"
          ],
          "whenToUse": [
            "expand cron occurrences in a supplied UTC window",
            "enumerate fixed-offset or UTC cron schedules offline",
            "inspect cron gap and fold matches against supplied offset periods"
          ],
          "whenNotToUse": [
            "An IANA timezone name without an explicit trusted offset-period timeline",
            "Daemon scheduling, Cronie clock-jump replay, catch-up or once-per-wall-time suppression",
            "Quartz, seconds/year fields, names, macros, hashed values, command suffixes or Sunday 7",
            "Accessing calendars, scheduling jobs, reserving meetings, network requests or external state changes"
          ],
          "capabilities": [
            "UTC and fixed offsets need one period spanning the exact window; labels are inert metadata and timezone rules are unverified",
            "Sorted contiguous offset periods are normalized; splitting equal-offset periods leaves output unchanged",
            "Exact five-field decimal grammar; positive steps only on * or ascending ranges",
            "Day-of-month/day-of-week use OR when both restricted; either exact wildcard delegates to the other; stepped wildcards in these day fields are rejected",
            "Minute-aligned half-open UTC window, Gregorian dates, gap omission and every distinct fold instant; no hidden current time",
            "Caller-supplied data only; no current clock, randomness, environment or timezone-database reads",
            "Complete bounded validation before payment challenge; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "profile": "cron5-offset-periods-v1",
            "expressionCodeUnits": 256,
            "atoms": 32,
            "offsetPeriods": 32,
            "absoluteOffsetMinutes": 840,
            "windowDays": 366,
            "calendarDateVisits": 512,
            "prospectiveCandidates": 50000,
            "occurrences": 2000,
            "utcYears": "2000–2100",
            "timezoneLabelCodeUnits": 128
          },
          "related": [
            "recurrence-dates-expand",
            "timezone-convert",
            "icalendar-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_CRON",
            "INVALID_UTC_TIME",
            "INVALID_WINDOW",
            "INVALID_OFFSET_PERIODS"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "expression": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256
                  },
                  "window": {
                    "type": "object",
                    "properties": {
                      "start": {
                        "type": "string",
                        "minLength": 20,
                        "maxLength": 20,
                        "pattern": "^(?:20[0-9]{2}|2100)-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00Z$"
                      },
                      "end": {
                        "type": "string",
                        "minLength": 20,
                        "maxLength": 20,
                        "pattern": "^(?:20[0-9]{2}|2100)-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00Z$"
                      }
                    },
                    "required": [
                      "start",
                      "end"
                    ],
                    "additionalProperties": false
                  },
                  "timezone": {
                    "type": "object",
                    "properties": {
                      "label": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 128,
                        "pattern": "^[\\x20-\\x7e]+$"
                      },
                      "periods": {
                        "minItems": 1,
                        "maxItems": 32,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "start": {
                              "type": "string",
                              "minLength": 20,
                              "maxLength": 20,
                              "pattern": "^(?:20[0-9]{2}|2100)-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00Z$"
                            },
                            "end": {
                              "type": "string",
                              "minLength": 20,
                              "maxLength": 20,
                              "pattern": "^(?:20[0-9]{2}|2100)-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00Z$"
                            },
                            "offsetMinutes": {
                              "type": "integer",
                              "minimum": -840,
                              "maximum": 840
                            }
                          },
                          "required": [
                            "start",
                            "end",
                            "offsetMinutes"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "label",
                      "periods"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "expression",
                  "window",
                  "timezone"
                ],
                "additionalProperties": false
              },
              "example": {
                "expression": "0 9 * * 1-5",
                "window": {
                  "start": "2026-10-05T00:00:00Z",
                  "end": "2026-10-08T00:00:00Z"
                },
                "timezone": {
                  "label": "UTC",
                  "periods": [
                    {
                      "start": "2026-10-05T00:00:00Z",
                      "end": "2026-10-08T00:00:00Z",
                      "offsetMinutes": 0
                    }
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "cron-occurrences-expand",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "cron5-offset-periods-v1"
                        },
                        "timezoneLabel": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128,
                          "pattern": "^[\\x20-\\x7e]+$"
                        },
                        "occurrences": {
                          "maxItems": 2000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "instant": {
                                "type": "string",
                                "minLength": 20,
                                "maxLength": 20,
                                "pattern": "^(?:20[0-9]{2}|2100)-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00Z$"
                              },
                              "localDateTime": {
                                "type": "string",
                                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:00$"
                              },
                              "offsetMinutes": {
                                "type": "integer",
                                "minimum": -840,
                                "maximum": 840
                              }
                            },
                            "required": [
                              "instant",
                              "localDateTime",
                              "offsetMinutes"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "complete": {
                          "type": "boolean",
                          "const": true
                        },
                        "rulesSource": {
                          "type": "string",
                          "const": "caller-supplied-offset-periods"
                        },
                        "timezoneRulesVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        }
                      },
                      "required": [
                        "profile",
                        "timezoneLabel",
                        "occurrences",
                        "complete",
                        "rulesSource",
                        "timezoneRulesVerified",
                        "execution"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "cron-occurrences-expand",
                  "version": "0.29.0",
                  "result": {
                    "profile": "cron5-offset-periods-v1",
                    "timezoneLabel": "UTC",
                    "occurrences": [
                      {
                        "instant": "2026-10-05T09:00:00Z",
                        "localDateTime": "2026-10-05T09:00:00",
                        "offsetMinutes": 0
                      },
                      {
                        "instant": "2026-10-06T09:00:00Z",
                        "localDateTime": "2026-10-06T09:00:00",
                        "offsetMinutes": 0
                      },
                      {
                        "instant": "2026-10-07T09:00:00Z",
                        "localDateTime": "2026-10-07T09:00:00",
                        "offsetMinutes": 0
                      }
                    ],
                    "complete": true,
                    "rulesSource": "caller-supplied-offset-periods",
                    "timezoneRulesVerified": false,
                    "execution": false
                  },
                  "provenance": {
                    "inputSha256": "fe96d9515b4ae70eefd4667f72628cd07f8ccde455e53be969cc789539811a84",
                    "outputSha256": "9a7bd770faba0810104e5978c7661f2ff710afe70115d536c705d59a97b89a5b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/protobuf-message-compose": {
      "post": {
        "operationId": "mpp_protobuf_message_compose",
        "summary": "Typed bounded Protobuf message composer",
        "description": "Compose actual proto3 wire bytes, matching explicit schema and exact field offsets from bounded acyclic integer/string/bytes declarations. Deterministic under this profile only; no universal canonical serialization, RPC, transport, credentials or execution.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/protobuf-message-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Prepare a typed binary message from an explicit Protobuf schema",
            "Produce a portable proto3 file and auditable byte offsets"
          ],
          "whenToUse": [
            "Prepare an inert request body or artifact for a separately authorized Protobuf consumer"
          ],
          "whenNotToUse": [
            "Recursive/imported schemas, floats, fixed-width types, enums, maps, oneofs, extensions or well-known types",
            "gRPC framing, sending a request, signatures or cross-implementation byte canonicality",
            "Executing code, writing files, environment changes, network requests, publishing or deployment"
          ],
          "capabilities": [
            "Exact decimal integer ranges, optional presence, default elision and packed repeated integers/booleans",
            "Ascending field-number order, canonical padded Base64 and absolute half-open offsets",
            "Acyclic schema validation including generated JSON-name conflicts",
            "Complete bounded computation before payment challenge and execution; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "messageTypes": 8,
            "declaredFields": 64,
            "messageDepth": 6,
            "valuesIncludingRoot": 1024,
            "decodedBytes": 60000,
            "wireBytes": 80000,
            "offsetRecordsIncludingElements": 2048
          },
          "related": [
            "zip-store-compose",
            "oci-artifact-compose",
            "blob-decode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_PROTO_NAME",
            "DUPLICATE_MESSAGE",
            "DUPLICATE_FIELD",
            "DUPLICATE_JSON_NAME",
            "UNKNOWN_PROTO_TYPE",
            "RESERVED_FIELD_NUMBER",
            "INVALID_CARDINALITY",
            "RECURSIVE_SCHEMA",
            "INVALID_PROTO_VALUE",
            "INTEGER_RANGE",
            "INVALID_BASE64",
            "UNKNOWN_PROTO_FIELD",
            "PAYLOAD_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "messages": {
                    "minItems": 1,
                    "maxItems": 8,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                        },
                        "fields": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                              },
                              "number": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 536870911
                              },
                              "type": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                              },
                              "cardinality": {
                                "type": "string",
                                "enum": [
                                  "implicit",
                                  "optional",
                                  "repeated"
                                ]
                              }
                            },
                            "required": [
                              "name",
                              "number",
                              "type",
                              "cardinality"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "name",
                        "fields"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "rootType": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                  },
                  "value": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "$ref": "#/paths/~1v1~1mpp~1protobuf-message-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                    }
                  }
                },
                "required": [
                  "messages",
                  "rootType",
                  "value"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1protobuf-message-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1protobuf-message-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "messages": [
                  {
                    "name": "Packet",
                    "fields": [
                      {
                        "name": "count",
                        "number": 1,
                        "type": "uint32",
                        "cardinality": "optional"
                      },
                      {
                        "name": "label",
                        "number": 2,
                        "type": "string",
                        "cardinality": "optional"
                      },
                      {
                        "name": "deltas",
                        "number": 3,
                        "type": "sint32",
                        "cardinality": "repeated"
                      }
                    ]
                  }
                ],
                "rootType": "Packet",
                "value": {
                  "count": "150",
                  "label": "Hi",
                  "deltas": [
                    "-1",
                    "2",
                    "3"
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "protobuf-message-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "proto3-bounded-integer-message-v1"
                        },
                        "rootType": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                        },
                        "base64": {
                          "type": "string"
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 80000
                        },
                        "protoSource": {
                          "type": "string"
                        },
                        "fieldRecords": {
                          "maxItems": 2048,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string"
                              },
                              "fieldNumber": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 536870911
                              },
                              "wireType": {
                                "anyOf": [
                                  {
                                    "type": "number",
                                    "const": 0
                                  },
                                  {
                                    "type": "number",
                                    "const": 2
                                  }
                                ]
                              },
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "payloadStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "payloadEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 9007199254740991
                              },
                              "elements": {
                                "maxItems": 1023,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "path": {
                                      "type": "string"
                                    },
                                    "payloadStart": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    },
                                    "payloadEnd": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 9007199254740991
                                    }
                                  },
                                  "required": [
                                    "path",
                                    "payloadStart",
                                    "payloadEnd"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "path",
                              "fieldNumber",
                              "wireType",
                              "start",
                              "end",
                              "payloadStart",
                              "payloadEnd"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "complete": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "rootType",
                        "base64",
                        "byteLength",
                        "protoSource",
                        "fieldRecords",
                        "complete",
                        "execution",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "protobuf-message-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "proto3-bounded-integer-message-v1",
                    "rootType": "Packet",
                    "base64": "CJYBEgJIaRoDAQQG",
                    "byteLength": 12,
                    "protoSource": "syntax = \"proto3\";\nmessage Packet {\n  optional uint32 count = 1;\n  optional string label = 2;\n  repeated sint32 deltas = 3;\n}\n",
                    "fieldRecords": [
                      {
                        "path": "/count",
                        "fieldNumber": 1,
                        "wireType": 0,
                        "start": 0,
                        "end": 3,
                        "payloadStart": 1,
                        "payloadEnd": 3
                      },
                      {
                        "path": "/label",
                        "fieldNumber": 2,
                        "wireType": 2,
                        "start": 3,
                        "end": 7,
                        "payloadStart": 5,
                        "payloadEnd": 7
                      },
                      {
                        "path": "/deltas",
                        "fieldNumber": 3,
                        "wireType": 2,
                        "start": 7,
                        "end": 12,
                        "payloadStart": 9,
                        "payloadEnd": 12,
                        "elements": [
                          {
                            "path": "/deltas/0",
                            "payloadStart": 9,
                            "payloadEnd": 10
                          },
                          {
                            "path": "/deltas/1",
                            "payloadStart": 10,
                            "payloadEnd": 11
                          },
                          {
                            "path": "/deltas/2",
                            "payloadStart": 11,
                            "payloadEnd": 12
                          }
                        ]
                      }
                    ],
                    "complete": true,
                    "execution": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "b408754708266e49ebe24f5620847540cf73dccf8a16f19ec5b2e7bf3e3ac4c6",
                    "outputSha256": "d2b66c67ba54385c24d502b4bab22d424af5faf77f1068d9f6e365598339a003",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/workflow-automata-compose": {
      "post": {
        "operationId": "mpp_workflow_automata_compose",
        "summary": "Synchronous workflow language compiler",
        "description": "Compile two to four supplied deterministic finite event constraints into a minimized synchronous intersection machine, exact member classes and a shortest accepted trace. Missing transitions reject; no asynchronous interleaving, runtime execution, liveness, deadlock or authorization guarantee.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/workflow-automata-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Combine finite workflow constraints into one reusable deterministic machine",
            "Find the shortest event trace satisfying all supplied finite event policies"
          ],
          "whenToUse": [
            "Every component intentionally consumes every event from the same explicit common alphabet"
          ],
          "whenNotToUse": [
            "Asynchronous components, implicit unrelated-event self-loops, epsilon edges, guards, actions, counters or real-time predicates",
            "Policy appropriateness, safe concurrency, liveness, real-world deadlocks or permission to execute actions",
            "Executing code, writing files, environment changes, network requests, publishing or deployment"
          ],
          "capabilities": [
            "Reachable synchronous product, common rejecting sink and exact partition minimization",
            "Canonical breadth-first state IDs and lexicographically tied shortest accepted traces",
            "States without accepting continuations and explicit product-class membership",
            "Complete bounded computation before payment challenge and execution; externalRequests=0"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 400000,
            "jsonNodes": 12000,
            "depth": 20,
            "machines": 4,
            "alphabet": 5,
            "statesPerMachine": 16,
            "inputStates": 64,
            "inputTransitions": 320,
            "reachableProductStates": 96,
            "productEdges": 480,
            "primitiveWork": 1000000
          },
          "related": [
            "workflow-transition-check",
            "workflow-dag-analyze"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_EVENT",
            "DUPLICATE_MACHINE",
            "DUPLICATE_STATE",
            "UNKNOWN_STATE",
            "UNKNOWN_EVENT",
            "DUPLICATE_TRANSITION"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "alphabet": {
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                    }
                  },
                  "machines": {
                    "minItems": 2,
                    "maxItems": 4,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                        },
                        "states": {
                          "minItems": 1,
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "initialState": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                        },
                        "acceptingStates": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "transitions": {
                          "maxItems": 80,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "from": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              },
                              "event": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              },
                              "to": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "required": [
                              "from",
                              "event",
                              "to"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "states",
                        "initialState",
                        "acceptingStates",
                        "transitions"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "alphabet",
                  "machines"
                ],
                "additionalProperties": false
              },
              "example": {
                "alphabet": [
                  "a",
                  "b"
                ],
                "machines": [
                  {
                    "id": "ending",
                    "states": [
                      "n",
                      "y"
                    ],
                    "initialState": "n",
                    "acceptingStates": [
                      "y"
                    ],
                    "transitions": [
                      {
                        "from": "n",
                        "event": "a",
                        "to": "y"
                      },
                      {
                        "from": "n",
                        "event": "b",
                        "to": "n"
                      },
                      {
                        "from": "y",
                        "event": "a",
                        "to": "y"
                      },
                      {
                        "from": "y",
                        "event": "b",
                        "to": "n"
                      }
                    ]
                  },
                  {
                    "id": "parity",
                    "states": [
                      "even",
                      "odd"
                    ],
                    "initialState": "even",
                    "acceptingStates": [
                      "even"
                    ],
                    "transitions": [
                      {
                        "from": "even",
                        "event": "a",
                        "to": "even"
                      },
                      {
                        "from": "even",
                        "event": "b",
                        "to": "odd"
                      },
                      {
                        "from": "odd",
                        "event": "a",
                        "to": "odd"
                      },
                      {
                        "from": "odd",
                        "event": "b",
                        "to": "even"
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "workflow-automata-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "finite-language-intersection-v1"
                        },
                        "semantics": {
                          "type": "string",
                          "const": "synchronous-common-alphabet"
                        },
                        "alphabet": {
                          "minItems": 1,
                          "maxItems": 5,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "machineOrder": {
                          "minItems": 2,
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "machine": {
                          "type": "object",
                          "properties": {
                            "states": {
                              "minItems": 1,
                              "maxItems": 96,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "initialState": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "acceptingStates": {
                              "maxItems": 96,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "transitions": {
                              "maxItems": 480,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "from": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                  },
                                  "event": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                  },
                                  "to": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                  }
                                },
                                "required": [
                                  "from",
                                  "event",
                                  "to"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "states",
                            "initialState",
                            "acceptingStates",
                            "transitions"
                          ],
                          "additionalProperties": false
                        },
                        "stateClasses": {
                          "minItems": 1,
                          "maxItems": 96,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "state": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              },
                              "memberTuples": {
                                "minItems": 1,
                                "maxItems": 96,
                                "type": "array",
                                "items": {
                                  "anyOf": [
                                    {
                                      "minItems": 2,
                                      "maxItems": 4,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                      }
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              }
                            },
                            "required": [
                              "state",
                              "memberTuples"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "shortestAcceptedTrace": {
                          "anyOf": [
                            {
                              "maxItems": 95,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "noAcceptingContinuationStates": {
                          "maxItems": 96,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "reachableProductStates": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 96
                        },
                        "complete": {
                          "type": "boolean",
                          "const": true
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "authorizationGranted": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "semantics",
                        "alphabet",
                        "machineOrder",
                        "machine",
                        "stateClasses",
                        "shortestAcceptedTrace",
                        "noAcceptingContinuationStates",
                        "reachableProductStates",
                        "complete",
                        "execution",
                        "authorizationGranted",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "workflow-automata-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "finite-language-intersection-v1",
                    "semantics": "synchronous-common-alphabet",
                    "alphabet": [
                      "a",
                      "b"
                    ],
                    "machineOrder": [
                      "ending",
                      "parity"
                    ],
                    "machine": {
                      "states": [
                        "q0",
                        "q1",
                        "q2"
                      ],
                      "initialState": "q0",
                      "acceptingStates": [
                        "q1"
                      ],
                      "transitions": [
                        {
                          "from": "q0",
                          "event": "a",
                          "to": "q1"
                        },
                        {
                          "from": "q0",
                          "event": "b",
                          "to": "q2"
                        },
                        {
                          "from": "q1",
                          "event": "a",
                          "to": "q1"
                        },
                        {
                          "from": "q1",
                          "event": "b",
                          "to": "q2"
                        },
                        {
                          "from": "q2",
                          "event": "a",
                          "to": "q2"
                        },
                        {
                          "from": "q2",
                          "event": "b",
                          "to": "q0"
                        }
                      ]
                    },
                    "stateClasses": [
                      {
                        "state": "q0",
                        "memberTuples": [
                          [
                            "n",
                            "even"
                          ]
                        ]
                      },
                      {
                        "state": "q1",
                        "memberTuples": [
                          [
                            "y",
                            "even"
                          ]
                        ]
                      },
                      {
                        "state": "q2",
                        "memberTuples": [
                          [
                            "n",
                            "odd"
                          ],
                          [
                            "y",
                            "odd"
                          ]
                        ]
                      }
                    ],
                    "shortestAcceptedTrace": [
                      "a"
                    ],
                    "noAcceptingContinuationStates": [],
                    "reachableProductStates": 4,
                    "complete": true,
                    "execution": false,
                    "authorizationGranted": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "67dafd2ccbbaa103d855310026fdbc6b8acc1b834468f130799030cf5ff348f2",
                    "outputSha256": "aa31a1b70e2b92d8c5ac67347d585ec1e211579759ddc258df4a7ad7161cc5a7",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/pairwise-cases-compose": {
      "post": {
        "operationId": "mpp_pairwise_cases_compose",
        "summary": "Constrained pairwise fixture composer",
        "description": "Generate concrete rows covering every pair with a feasible complete assignment under bounded forbidden tuples, with exhaustive-coverage certificate and deterministic greedy ties. No minimum-suite or target-behavior claim.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/pairwise-cases-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate constrained pairwise test configurations",
            "Build concrete finite factor-level fixtures and a coverage manifest"
          ],
          "whenToUse": [
            "Ordered finite factors with literal forbidden tuples; caller separately runs tests"
          ],
          "whenNotToUse": [
            "Minimum test suites, arbitrary SAT predicates, unlimited Cartesian products or bug-finding guarantees",
            "Execute target code, call APIs, fetch data, run external agents, mutate accounts or deploy"
          ],
          "capabilities": [
            "Complete Cartesian feasibility enumeration and feasible-pair derivation",
            "Deterministic greedy coverage with first-covering row certificate",
            "Complete bounded result computed before challenge; atomic work/output failures"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 16,
            "factors": 12,
            "levelsPerFactor": 16,
            "forbiddenTuples": 64,
            "tupleArity": 4,
            "cartesianAssignments": 4096,
            "pairEntries": 4096,
            "suiteRows": 256,
            "tupleLiteralTests": 1100000,
            "pairPostings": 270336,
            "scoreComparisons": 1048576
          },
          "related": [
            "coverage-set-optimize",
            "json-batch-encode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_FACTOR",
            "DUPLICATE_LEVEL",
            "DUPLICATE_TUPLE_FACTOR",
            "UNKNOWN_LEVEL",
            "LABEL_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "factors": {
                    "minItems": 2,
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                        },
                        "levels": {
                          "minItems": 1,
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "string",
                                "maxLength": 128
                              },
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        }
                      },
                      "required": [
                        "id",
                        "levels"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "forbiddenTuples": {
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "factor": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          },
                          "levelIndex": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 15
                          }
                        },
                        "required": [
                          "factor",
                          "levelIndex"
                        ],
                        "additionalProperties": false
                      }
                    }
                  }
                },
                "required": [
                  "factors",
                  "forbiddenTuples"
                ],
                "additionalProperties": false
              },
              "example": {
                "factors": [
                  {
                    "id": "codec",
                    "levels": [
                      "json",
                      "msgpack"
                    ]
                  },
                  {
                    "id": "compression",
                    "levels": [
                      "none",
                      "gzip"
                    ]
                  },
                  {
                    "id": "transport",
                    "levels": [
                      "http",
                      "ws"
                    ]
                  }
                ],
                "forbiddenTuples": [
                  [
                    {
                      "factor": "codec",
                      "levelIndex": 1
                    },
                    {
                      "factor": "compression",
                      "levelIndex": 1
                    }
                  ]
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "pairwise-cases-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "finite-forbidden-tuples-greedy-pairwise-v1"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "complete",
                            "infeasible"
                          ]
                        },
                        "factorOrder": {
                          "minItems": 2,
                          "maxItems": 12,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                          }
                        },
                        "rows": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "maxLength": 128
                                },
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          }
                        },
                        "levelIndexRows": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "minItems": 2,
                            "maxItems": 12,
                            "type": "array",
                            "items": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 15
                            }
                          }
                        },
                        "coverage": {
                          "type": "object",
                          "properties": {
                            "cartesianAssignmentCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 4096
                            },
                            "feasibleAssignmentCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 4096
                            },
                            "nominalPairCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "feasiblePairCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 4096
                            },
                            "excludedPairCount": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 9007199254740991
                            },
                            "pairs": {
                              "maxItems": 4096,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "factorIndexA": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 11
                                  },
                                  "levelIndexA": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 15
                                  },
                                  "factorIndexB": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 11
                                  },
                                  "levelIndexB": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 15
                                  },
                                  "firstCoveringRow": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 255
                                  }
                                },
                                "required": [
                                  "factorIndexA",
                                  "levelIndexA",
                                  "factorIndexB",
                                  "levelIndexB",
                                  "firstCoveringRow"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "complete": {
                              "type": "boolean",
                              "const": true
                            }
                          },
                          "required": [
                            "cartesianAssignmentCount",
                            "feasibleAssignmentCount",
                            "nominalPairCount",
                            "feasiblePairCount",
                            "excludedPairCount",
                            "pairs",
                            "complete"
                          ],
                          "additionalProperties": false
                        },
                        "minimumSuiteClaimed": {
                          "type": "boolean",
                          "const": false
                        },
                        "targetExecuted": {
                          "type": "boolean",
                          "const": false
                        },
                        "behaviorVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "factorOrder",
                        "rows",
                        "levelIndexRows",
                        "coverage",
                        "minimumSuiteClaimed",
                        "targetExecuted",
                        "behaviorVerified",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "pairwise-cases-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "finite-forbidden-tuples-greedy-pairwise-v1",
                    "status": "complete",
                    "factorOrder": [
                      "codec",
                      "compression",
                      "transport"
                    ],
                    "rows": [
                      {
                        "codec": "json",
                        "compression": "none",
                        "transport": "http"
                      },
                      {
                        "codec": "json",
                        "compression": "gzip",
                        "transport": "ws"
                      },
                      {
                        "codec": "msgpack",
                        "compression": "none",
                        "transport": "ws"
                      },
                      {
                        "codec": "json",
                        "compression": "gzip",
                        "transport": "http"
                      },
                      {
                        "codec": "msgpack",
                        "compression": "none",
                        "transport": "http"
                      }
                    ],
                    "levelIndexRows": [
                      [
                        0,
                        0,
                        0
                      ],
                      [
                        0,
                        1,
                        1
                      ],
                      [
                        1,
                        0,
                        1
                      ],
                      [
                        0,
                        1,
                        0
                      ],
                      [
                        1,
                        0,
                        0
                      ]
                    ],
                    "coverage": {
                      "cartesianAssignmentCount": 8,
                      "feasibleAssignmentCount": 6,
                      "nominalPairCount": 12,
                      "feasiblePairCount": 11,
                      "excludedPairCount": 1,
                      "pairs": [
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 0,
                          "factorIndexB": 1,
                          "levelIndexB": 0,
                          "firstCoveringRow": 0
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 0,
                          "factorIndexB": 1,
                          "levelIndexB": 1,
                          "firstCoveringRow": 1
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 1,
                          "factorIndexB": 1,
                          "levelIndexB": 0,
                          "firstCoveringRow": 2
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 0,
                          "factorIndexB": 2,
                          "levelIndexB": 0,
                          "firstCoveringRow": 0
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 0,
                          "factorIndexB": 2,
                          "levelIndexB": 1,
                          "firstCoveringRow": 1
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 1,
                          "factorIndexB": 2,
                          "levelIndexB": 0,
                          "firstCoveringRow": 4
                        },
                        {
                          "factorIndexA": 0,
                          "levelIndexA": 1,
                          "factorIndexB": 2,
                          "levelIndexB": 1,
                          "firstCoveringRow": 2
                        },
                        {
                          "factorIndexA": 1,
                          "levelIndexA": 0,
                          "factorIndexB": 2,
                          "levelIndexB": 0,
                          "firstCoveringRow": 0
                        },
                        {
                          "factorIndexA": 1,
                          "levelIndexA": 0,
                          "factorIndexB": 2,
                          "levelIndexB": 1,
                          "firstCoveringRow": 2
                        },
                        {
                          "factorIndexA": 1,
                          "levelIndexA": 1,
                          "factorIndexB": 2,
                          "levelIndexB": 0,
                          "firstCoveringRow": 3
                        },
                        {
                          "factorIndexA": 1,
                          "levelIndexA": 1,
                          "factorIndexB": 2,
                          "levelIndexB": 1,
                          "firstCoveringRow": 1
                        }
                      ],
                      "complete": true
                    },
                    "minimumSuiteClaimed": false,
                    "targetExecuted": false,
                    "behaviorVerified": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "135abef0c032aca1063b6b8b62cac1383fb8a7ae86d14ac53c6db804c01e967d",
                    "outputSha256": "0bc60129130519d35d6e26acf194b298be21d801098331327f1e42a1643cd77c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.01",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/synthetic-records-compose": {
      "post": {
        "operationId": "mpp_synthetic_records_compose",
        "summary": "Versioned seeded synthetic record composer",
        "description": "Generate reproducible JSON records from explicit integer sequences, uniform integers, Bernoulli draws and integer-weighted categories using sha256-counter-fields-v1. No real-PII source, population realism, privacy certification or cryptographic-randomness claim.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/synthetic-records-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate repeatable parser fixtures with an exact seed and distribution recipe",
            "Compose explicit synthetic records without a reference dataset"
          ],
          "whenToUse": [
            "Small inert fixture tables from elementary explicit sampling rules"
          ],
          "whenNotToUse": [
            "Exact quotas, realistic identities, PII anonymization, correlated populations, Gaussian or floating-point distributions",
            "Cryptographic tokens, secrets or unpredictable random draws",
            "Execute target code, call APIs, fetch data, run external agents, mutate accounts or deploy"
          ],
          "capabilities": [
            "Frozen SHA-256 field-addressed rejection sampling with independent field addition",
            "Returns complete recipe and version alongside all generated rows",
            "Complete bounded result computed before challenge; atomic work/output failures"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 16,
            "rows": 1000,
            "fields": 20,
            "cells": 3000,
            "categories": 32,
            "distributionRange": 1000000,
            "hashAttempts": 3150,
            "attemptsPerDraw": 32,
            "scalarLabelCodePoints": 64
          },
          "related": [
            "csv-serialize",
            "json-batch-encode"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_FIELD",
            "DUPLICATE_CATEGORY",
            "LABEL_LIMIT",
            "INTEGER_RANGE",
            "INVALID_DISTRIBUTION",
            "SAMPLING_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "seed": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 4294967295
                  },
                  "count": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000
                  },
                  "fields": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "sequence"
                            },
                            "start": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "step": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "start",
                            "step"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "uniformInteger"
                            },
                            "minimum": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "maximum": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "minimum",
                            "maximum"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "bernoulli"
                            },
                            "numerator": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1000000
                            },
                            "denominator": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 1000000
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "kind": {
                              "type": "string",
                              "const": "categorical"
                            },
                            "values": {
                              "minItems": 1,
                              "maxItems": 32,
                              "type": "array",
                              "items": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 128
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "boolean"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "weights": {
                              "minItems": 1,
                              "maxItems": 32,
                              "type": "array",
                              "items": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              }
                            }
                          },
                          "required": [
                            "id",
                            "kind",
                            "values",
                            "weights"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "seed",
                  "count",
                  "fields"
                ],
                "additionalProperties": false
              },
              "example": {
                "seed": 7,
                "count": 5,
                "fields": [
                  {
                    "id": "rowId",
                    "kind": "sequence",
                    "start": 100,
                    "step": 1
                  },
                  {
                    "id": "tier",
                    "kind": "categorical",
                    "values": [
                      "free",
                      "pro"
                    ],
                    "weights": [
                      3,
                      1
                    ]
                  },
                  {
                    "id": "retries",
                    "kind": "uniformInteger",
                    "minimum": 0,
                    "maximum": 2
                  },
                  {
                    "id": "enabled",
                    "kind": "bernoulli",
                    "numerator": 1,
                    "denominator": 2
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "synthetic-records-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "sha256-counter-fields-v1"
                        },
                        "recipe": {
                          "type": "object",
                          "properties": {
                            "seed": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 4294967295
                            },
                            "count": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1000
                            },
                            "fields": {
                              "minItems": 1,
                              "maxItems": 20,
                              "type": "array",
                              "items": {
                                "oneOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "sequence"
                                      },
                                      "start": {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      },
                                      "step": {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "start",
                                      "step"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "uniformInteger"
                                      },
                                      "minimum": {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      },
                                      "maximum": {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "minimum",
                                      "maximum"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "bernoulli"
                                      },
                                      "numerator": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 1000000
                                      },
                                      "denominator": {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 1000000
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                      },
                                      "kind": {
                                        "type": "string",
                                        "const": "categorical"
                                      },
                                      "values": {
                                        "minItems": 1,
                                        "maxItems": 32,
                                        "type": "array",
                                        "items": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "maxLength": 128
                                            },
                                            {
                                              "type": "integer",
                                              "minimum": -9007199254740991,
                                              "maximum": 9007199254740991
                                            },
                                            {
                                              "type": "boolean"
                                            },
                                            {
                                              "type": "null"
                                            }
                                          ]
                                        }
                                      },
                                      "weights": {
                                        "minItems": 1,
                                        "maxItems": 32,
                                        "type": "array",
                                        "items": {
                                          "type": "integer",
                                          "minimum": 0,
                                          "maximum": 1000000
                                        }
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "kind",
                                      "values",
                                      "weights"
                                    ],
                                    "additionalProperties": false
                                  }
                                ]
                              }
                            }
                          },
                          "required": [
                            "seed",
                            "count",
                            "fields"
                          ],
                          "additionalProperties": false
                        },
                        "generatedCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000
                        },
                        "rows": {
                          "maxItems": 1000,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "propertyNames": {
                              "type": "string"
                            },
                            "additionalProperties": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "maxLength": 128
                                },
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          }
                        },
                        "hashAttempts": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 3150
                        },
                        "distributionSemantics": {
                          "type": "string",
                          "const": "addressed-pseudorandom-draws-not-exact-quotas"
                        },
                        "cryptographicRandomnessClaimed": {
                          "type": "boolean",
                          "const": false
                        },
                        "privacyCertification": {
                          "type": "boolean",
                          "const": false
                        },
                        "targetExecuted": {
                          "type": "boolean",
                          "const": false
                        },
                        "behaviorVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "recipe",
                        "generatedCount",
                        "rows",
                        "hashAttempts",
                        "distributionSemantics",
                        "cryptographicRandomnessClaimed",
                        "privacyCertification",
                        "targetExecuted",
                        "behaviorVerified",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "synthetic-records-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "sha256-counter-fields-v1",
                    "recipe": {
                      "seed": 7,
                      "count": 5,
                      "fields": [
                        {
                          "id": "rowId",
                          "kind": "sequence",
                          "start": 100,
                          "step": 1
                        },
                        {
                          "id": "tier",
                          "kind": "categorical",
                          "values": [
                            "free",
                            "pro"
                          ],
                          "weights": [
                            3,
                            1
                          ]
                        },
                        {
                          "id": "retries",
                          "kind": "uniformInteger",
                          "minimum": 0,
                          "maximum": 2
                        },
                        {
                          "id": "enabled",
                          "kind": "bernoulli",
                          "numerator": 1,
                          "denominator": 2
                        }
                      ]
                    },
                    "generatedCount": 5,
                    "rows": [
                      {
                        "rowId": 100,
                        "tier": "free",
                        "retries": 2,
                        "enabled": true
                      },
                      {
                        "rowId": 101,
                        "tier": "pro",
                        "retries": 2,
                        "enabled": false
                      },
                      {
                        "rowId": 102,
                        "tier": "free",
                        "retries": 1,
                        "enabled": true
                      },
                      {
                        "rowId": 103,
                        "tier": "free",
                        "retries": 1,
                        "enabled": true
                      },
                      {
                        "rowId": 104,
                        "tier": "pro",
                        "retries": 0,
                        "enabled": true
                      }
                    ],
                    "hashAttempts": 15,
                    "distributionSemantics": "addressed-pseudorandom-draws-not-exact-quotas",
                    "cryptographicRandomnessClaimed": false,
                    "privacyCertification": false,
                    "targetExecuted": false,
                    "behaviorVerified": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "909c7edf379b64904f4ded14a7059683a2de705bf8b90eadc574113e1dccf8c9",
                    "outputSha256": "c718fd50db16b53e1c7e64358975ce68a5efb0a3079ebccf04853683a3921f4b",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/observation-shrink-plan": {
      "post": {
        "operationId": "mpp_observation_shrink_plan",
        "summary": "Observed failure reduction planner",
        "description": "Select the smallest target-failing subsequence among supplied observations, reconcile conflicting evidence, and materialize missing one-deletion experiments. References are caller assertions; no target execution, reproduced bug or global minimum claim.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/observation-shrink-plan.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Plan next reduction experiments from caller-supplied failure observations",
            "Materialize the smallest observed target-failing sequence and its evidence"
          ],
          "whenToUse": [
            "Caller already owns a harness and supplies bounded pass/fail/unresolved observations"
          ],
          "whenNotToUse": [
            "Autonomous ddmin, reproducing bugs, root-cause claims, global minimality or executing a target",
            "Unobserved harness identity, flakiness or causality verification",
            "Execute target code, call APIs, fetch data, run external agents, mutate accounts or deploy"
          ],
          "capabilities": [
            "Conflicting evidence detection and target-failure-aware deterministic selection",
            "Concrete one-deletion input queue, complete local supplied-pass certificate or explicit incompleteness",
            "Complete bounded result computed before challenge; atomic work/output failures"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 16,
            "atoms": 64,
            "observations": 512,
            "retainedIds": 64,
            "observationIdReferences": 16384,
            "atomValueBytes": 512,
            "nextExperiments": 64
          },
          "related": [
            "replay-divergence-check",
            "json-patch"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "DUPLICATE_ATOM",
            "DUPLICATE_OBSERVATION",
            "ATOM_LIMIT",
            "UNKNOWN_ATOM",
            "INVALID_SUBSEQUENCE",
            "CONTEXT_MISMATCH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "atoms": {
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                        },
                        "value": {
                          "$ref": "#/paths/~1v1~1mpp~1observation-shrink-plan/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      "required": [
                        "id",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "initialRetainedIds": {
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                    }
                  },
                  "harnessRef": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "caseRef": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "failureKey": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 128
                  },
                  "observations": {
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "harnessRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "caseRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "retainedIds": {
                              "maxItems": 64,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "outcome": {
                              "type": "string",
                              "const": "pass"
                            }
                          },
                          "required": [
                            "id",
                            "harnessRef",
                            "caseRef",
                            "retainedIds",
                            "outcome"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "harnessRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "caseRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "retainedIds": {
                              "maxItems": 64,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "outcome": {
                              "type": "string",
                              "const": "unresolved"
                            }
                          },
                          "required": [
                            "id",
                            "harnessRef",
                            "caseRef",
                            "retainedIds",
                            "outcome"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                            },
                            "harnessRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "caseRef": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "retainedIds": {
                              "maxItems": 64,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              }
                            },
                            "outcome": {
                              "type": "string",
                              "const": "fail"
                            },
                            "failureKey": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            }
                          },
                          "required": [
                            "id",
                            "harnessRef",
                            "caseRef",
                            "retainedIds",
                            "outcome",
                            "failureKey"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "atoms",
                  "initialRetainedIds",
                  "harnessRef",
                  "caseRef",
                  "failureKey",
                  "observations"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1observation-shrink-plan/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1observation-shrink-plan/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "atoms": [
                  {
                    "id": "a",
                    "value": {
                      "op": "open"
                    }
                  },
                  {
                    "id": "b",
                    "value": {
                      "op": "configure",
                      "mode": "x"
                    }
                  },
                  {
                    "id": "c",
                    "value": {
                      "op": "trigger"
                    }
                  },
                  {
                    "id": "d",
                    "value": {
                      "op": "close"
                    }
                  }
                ],
                "initialRetainedIds": [
                  "a",
                  "b",
                  "c",
                  "d"
                ],
                "harnessRef": "harness-v1",
                "caseRef": "case-x",
                "failureKey": "E_X",
                "observations": [
                  {
                    "id": "full",
                    "harnessRef": "harness-v1",
                    "caseRef": "case-x",
                    "retainedIds": [
                      "a",
                      "b",
                      "c",
                      "d"
                    ],
                    "outcome": "fail",
                    "failureKey": "E_X"
                  },
                  {
                    "id": "reduced",
                    "harnessRef": "harness-v1",
                    "caseRef": "case-x",
                    "retainedIds": [
                      "a",
                      "c"
                    ],
                    "outcome": "fail",
                    "failureKey": "E_X"
                  },
                  {
                    "id": "a-pass",
                    "harnessRef": "harness-v1",
                    "caseRef": "case-x",
                    "retainedIds": [
                      "a"
                    ],
                    "outcome": "pass"
                  },
                  {
                    "id": "c-unresolved",
                    "harnessRef": "harness-v1",
                    "caseRef": "case-x",
                    "retainedIds": [
                      "c"
                    ],
                    "outcome": "unresolved"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "observation-shrink-plan",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "supplied-observations-one-deletion-v1"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "planned",
                            "inconsistent-evidence",
                            "no-target-failure-observed"
                          ]
                        },
                        "harnessRef": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "caseRef": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "failureKey": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "selected": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "retainedIds": {
                                  "maxItems": 64,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                  }
                                },
                                "values": {
                                  "maxItems": 64,
                                  "type": "array",
                                  "items": {
                                    "$ref": "#/paths/~1v1~1mpp~1observation-shrink-plan/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "observationIds": {
                                  "maxItems": 512,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                  }
                                }
                              },
                              "required": [
                                "retainedIds",
                                "values",
                                "observationIds"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "smallestAmongSuppliedObservations": {
                          "type": "boolean"
                        },
                        "globalMinimalityEstablished": {
                          "type": "boolean",
                          "const": false
                        },
                        "oneDeletionCertificate": {
                          "type": "string",
                          "enum": [
                            "supported-by-supplied-passes",
                            "incomplete",
                            "not-applicable"
                          ]
                        },
                        "neighbors": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "omittedAtomId": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              },
                              "retainedIds": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                }
                              },
                              "evidenceStatus": {
                                "type": "string",
                                "enum": [
                                  "pass",
                                  "unresolved",
                                  "untested",
                                  "other-failure"
                                ]
                              },
                              "observationIds": {
                                "maxItems": 512,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                }
                              }
                            },
                            "required": [
                              "omittedAtomId",
                              "retainedIds",
                              "evidenceStatus",
                              "observationIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "nextExperiments": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "harnessRef": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              "caseRef": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              "targetFailureKey": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              "omittedAtomId": {
                                "type": "string",
                                "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                              },
                              "retainedIds": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                }
                              },
                              "values": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "$ref": "#/paths/~1v1~1mpp~1observation-shrink-plan/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                }
                              },
                              "reason": {
                                "type": "string",
                                "enum": [
                                  "unresolved",
                                  "untested",
                                  "other-failure"
                                ]
                              }
                            },
                            "required": [
                              "harnessRef",
                              "caseRef",
                              "targetFailureKey",
                              "omittedAtomId",
                              "retainedIds",
                              "values",
                              "reason"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "conflicts": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "retainedIds": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                }
                              },
                              "observationIds": {
                                "maxItems": 512,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,63}$"
                                }
                              }
                            },
                            "required": [
                              "retainedIds",
                              "observationIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "targetExecuted": {
                          "type": "boolean",
                          "const": false
                        },
                        "behaviorVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "harnessRef",
                        "caseRef",
                        "failureKey",
                        "selected",
                        "smallestAmongSuppliedObservations",
                        "globalMinimalityEstablished",
                        "oneDeletionCertificate",
                        "neighbors",
                        "nextExperiments",
                        "conflicts",
                        "targetExecuted",
                        "behaviorVerified",
                        "externalRequests"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1observation-shrink-plan/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1observation-shrink-plan/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "observation-shrink-plan",
                  "version": "0.29.0",
                  "result": {
                    "profile": "supplied-observations-one-deletion-v1",
                    "status": "planned",
                    "harnessRef": "harness-v1",
                    "caseRef": "case-x",
                    "failureKey": "E_X",
                    "selected": {
                      "retainedIds": [
                        "a",
                        "c"
                      ],
                      "values": [
                        {
                          "op": "open"
                        },
                        {
                          "op": "trigger"
                        }
                      ],
                      "observationIds": [
                        "reduced"
                      ]
                    },
                    "smallestAmongSuppliedObservations": true,
                    "globalMinimalityEstablished": false,
                    "oneDeletionCertificate": "incomplete",
                    "neighbors": [
                      {
                        "omittedAtomId": "a",
                        "retainedIds": [
                          "c"
                        ],
                        "evidenceStatus": "unresolved",
                        "observationIds": [
                          "c-unresolved"
                        ]
                      },
                      {
                        "omittedAtomId": "c",
                        "retainedIds": [
                          "a"
                        ],
                        "evidenceStatus": "pass",
                        "observationIds": [
                          "a-pass"
                        ]
                      }
                    ],
                    "nextExperiments": [
                      {
                        "harnessRef": "harness-v1",
                        "caseRef": "case-x",
                        "targetFailureKey": "E_X",
                        "omittedAtomId": "a",
                        "retainedIds": [
                          "c"
                        ],
                        "values": [
                          {
                            "op": "trigger"
                          }
                        ],
                        "reason": "unresolved"
                      }
                    ],
                    "conflicts": [],
                    "targetExecuted": false,
                    "behaviorVerified": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "67fbcdaab9d5b3fd35e6bf7d29e597bfffa06f507f26b5bd0f40c85e5809307a",
                    "outputSha256": "25ef2cfd69a0b40f6cd46f38112bed174cf4e4f5d35867388bd82becec52855a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-schema-fixtures-compose": {
      "post": {
        "operationId": "mpp_json_schema_fixtures_compose",
        "summary": "Constructive typed-schema fixture composer",
        "description": "Compose a complete bounded basis of valid fixture values with per-goal coverage or unavailability under a small typed JSON Schema profile.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-schema-fixtures-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "generate valid boundary request bodies from a supported typed JSON schema",
            "compose goal-labelled schema fixtures for a caller-run validator harness"
          ],
          "whenToUse": [
            "generate valid boundary request bodies from a supported typed JSON schema",
            "compose goal-labelled schema fixtures for a caller-run validator harness"
          ],
          "whenNotToUse": [
            "Exhaustive input-space, every property combination or every array-position coverage",
            "Counterexamples proving schema compatibility or arbitrary satisfiability search",
            "Arbitrary JSON Schema, formats, regexes, references, combinators, nested objects or nested arrays",
            "Executing target tests, fetching services, running supplied code or proving security"
          ],
          "capabilities": [
            "Required-only baseline, one-property edges, optional presence, array length edges and first-item scalar edges",
            "Typed enum/const intersections and supported contradictions; impossible optional properties stay explicitly unavailable",
            "Deduplicated fixture values retain all construction goal IDs",
            "Closed constructive-json-schema-v1 profile; unsupported keywords are rejected rather than ignored",
            "Networkless deterministic supplied-data computation; no target behavior or full input-space coverage claim",
            "Atomic complete bounded computation before the payment challenge; no partial packet on resource overflow"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "inputNodes": 12000,
            "outputNodes": 50000,
            "depth": 16,
            "schemaNodes": 80,
            "properties": 32,
            "enumMembers": 16,
            "arrayItems": 16,
            "stringLength": 256,
            "fixtures": 128,
            "goals": 512,
            "mutations": 64,
            "validatorNodeVisits": 50000,
            "candidateBytes": 2000000,
            "jsonNodes": 12000,
            "profile": "constructive-json-schema-v1"
          },
          "related": [
            "json-contract-negative-cases",
            "json-schema-check",
            "json-schema-compatibility"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "UNSUPPORTED_SCHEMA",
            "INVALID_SCHEMA",
            "SCHEMA_LIMIT",
            "WORK_LIMIT",
            "GOAL_LIMIT",
            "FIXTURE_LIMIT",
            "SEED_LIMIT",
            "INVALID_SEED",
            "DUPLICATE_ID",
            "INVALID_POINTER",
            "MUTATION_LIMIT",
            "INTERNAL_INVARIANT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "schema": {
                    "$ref": "#/paths/~1v1~1mpp~1json-schema-fixtures-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "schema"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-schema-fixtures-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-schema-fixtures-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "schema": {
                  "type": "object",
                  "required": [
                    "count",
                    "mode"
                  ],
                  "properties": {
                    "count": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 3
                    },
                    "mode": {
                      "type": "string",
                      "enum": [
                        "fast",
                        "safe"
                      ]
                    }
                  },
                  "additionalProperties": false
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-schema-fixtures-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "constructive-json-schema-v1"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "complete",
                            "unsatisfiable"
                          ]
                        },
                        "fixtures": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "value": {
                                "$ref": "#/paths/~1v1~1mpp~1json-schema-fixtures-compose/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              },
                              "goalIds": {
                                "maxItems": 512,
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "required": [
                              "id",
                              "value",
                              "goalIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "goals": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string"
                              },
                              "instancePath": {
                                "type": "string"
                              },
                              "schemaPath": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "covered",
                                  "unavailable"
                                ]
                              },
                              "fixtureIds": {
                                "maxItems": 128,
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "reason": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "kind",
                              "instancePath",
                              "schemaPath",
                              "status",
                              "fixtureIds",
                              "reason"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "reason": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "code": {
                                  "type": "string"
                                },
                                "schemaPath": {
                                  "type": "string"
                                },
                                "message": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "code",
                                "schemaPath",
                                "message"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "testing": {
                          "type": "object",
                          "properties": {
                            "targetExecuted": {
                              "type": "boolean",
                              "const": false
                            },
                            "behaviorVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "fullInputSpaceCoverage": {
                              "type": "boolean",
                              "const": false
                            }
                          },
                          "required": [
                            "targetExecuted",
                            "behaviorVerified",
                            "fullInputSpaceCoverage"
                          ],
                          "additionalProperties": false
                        },
                        "metrics": {
                          "type": "object",
                          "properties": {
                            "schemaNodes": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "validatorNodeVisits": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "schemaNodes",
                            "validatorNodeVisits"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "fixtures",
                        "goals",
                        "reason",
                        "testing",
                        "metrics"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-schema-fixtures-compose/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-schema-fixtures-compose/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-schema-fixtures-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "constructive-json-schema-v1",
                    "status": "complete",
                    "fixtures": [
                      {
                        "id": "f001",
                        "value": {
                          "count": 1,
                          "mode": "fast"
                        },
                        "goalIds": [
                          "g001",
                          "g002",
                          "g004"
                        ]
                      },
                      {
                        "id": "f002",
                        "value": {
                          "count": 3,
                          "mode": "fast"
                        },
                        "goalIds": [
                          "g003"
                        ]
                      },
                      {
                        "id": "f003",
                        "value": {
                          "count": 1,
                          "mode": "safe"
                        },
                        "goalIds": [
                          "g005"
                        ]
                      }
                    ],
                    "goals": [
                      {
                        "id": "g001",
                        "kind": "baseline",
                        "instancePath": "",
                        "schemaPath": "",
                        "status": "covered",
                        "fixtureIds": [
                          "f001"
                        ],
                        "reason": null
                      },
                      {
                        "id": "g002",
                        "kind": "minimum",
                        "instancePath": "/count",
                        "schemaPath": "/properties/count/minimum",
                        "status": "covered",
                        "fixtureIds": [
                          "f001"
                        ],
                        "reason": null
                      },
                      {
                        "id": "g003",
                        "kind": "maximum",
                        "instancePath": "/count",
                        "schemaPath": "/properties/count/maximum",
                        "status": "covered",
                        "fixtureIds": [
                          "f002"
                        ],
                        "reason": null
                      },
                      {
                        "id": "g004",
                        "kind": "enum:0",
                        "instancePath": "/mode",
                        "schemaPath": "/properties/mode/enum",
                        "status": "covered",
                        "fixtureIds": [
                          "f001"
                        ],
                        "reason": null
                      },
                      {
                        "id": "g005",
                        "kind": "enum:1",
                        "instancePath": "/mode",
                        "schemaPath": "/properties/mode/enum",
                        "status": "covered",
                        "fixtureIds": [
                          "f003"
                        ],
                        "reason": null
                      }
                    ],
                    "reason": null,
                    "testing": {
                      "targetExecuted": false,
                      "behaviorVerified": false,
                      "fullInputSpaceCoverage": false
                    },
                    "metrics": {
                      "schemaNodes": 3,
                      "validatorNodeVisits": 17
                    }
                  },
                  "provenance": {
                    "inputSha256": "00ed529a30f8458abb6580d8672e529443e30ca8741a90bda07d2153fad821f4",
                    "outputSha256": "022438b15adb78e88f4cbcea2f92851f0f87f5b974e69d887628681ed5ad10d1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-contract-negative-cases": {
      "post": {
        "operationId": "mpp_json_contract_negative_cases",
        "summary": "Targeted JSON contract negative fixture composer",
        "description": "Compose invalid payloads from a caller-supplied valid seed with one structural edit, an exact target assertion and the complete bounded failed-assertion set.",
        "tags": [
          "api-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-contract-negative-cases.md"
        },
        "x-agent-discovery": {
          "intents": [
            "generate targeted negative request payloads from a valid JSON seed and supported schema",
            "compose one-edit contract violations with checked constraint isolation"
          ],
          "whenToUse": [
            "generate targeted negative request payloads from a valid JSON seed and supported schema",
            "compose one-edit contract violations with checked constraint isolation"
          ],
          "whenNotToUse": [
            "Target rejection guarantees, expected HTTP status, fuzz attacks or a mutation-testing score",
            "A valid seed is missing or incompatible with the supported structural schema",
            "Arbitrary JSON Schema, formats, regexes, references, combinators, nested objects or nested arrays",
            "Executing target tests, fetching services, running supplied code or proving security"
          ],
          "capabilities": [
            "Caller-supplied seed works independently of the valid-fixture tool",
            "One inert JSON Patch per generated case, explicit assertion identities and complete failed-assertion manifests",
            "requireIsolated suppresses fixtures with additional failures; unavailable requests have explicit reasons",
            "Closed constructive-json-schema-v1 profile; unsupported keywords are rejected rather than ignored",
            "Networkless deterministic supplied-data computation; no target behavior or full input-space coverage claim",
            "Atomic complete bounded computation before the payment challenge; no partial packet on resource overflow"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "inputNodes": 12000,
            "outputNodes": 50000,
            "depth": 16,
            "schemaNodes": 80,
            "properties": 32,
            "enumMembers": 16,
            "arrayItems": 16,
            "stringLength": 256,
            "fixtures": 128,
            "goals": 512,
            "mutations": 64,
            "validatorNodeVisits": 50000,
            "candidateBytes": 2000000,
            "jsonNodes": 12000,
            "profile": "constructive-json-schema-v1"
          },
          "related": [
            "json-schema-fixtures-compose",
            "json-schema-check",
            "json-patch"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "UNSUPPORTED_SCHEMA",
            "INVALID_SCHEMA",
            "SCHEMA_LIMIT",
            "WORK_LIMIT",
            "GOAL_LIMIT",
            "FIXTURE_LIMIT",
            "SEED_LIMIT",
            "INVALID_SEED",
            "DUPLICATE_ID",
            "INVALID_POINTER",
            "MUTATION_LIMIT",
            "INTERNAL_INVARIANT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "schema": {
                    "$ref": "#/paths/~1v1~1mpp~1json-contract-negative-cases/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "seed": {
                    "$ref": "#/paths/~1v1~1mpp~1json-contract-negative-cases/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  },
                  "mutations": {
                    "minItems": 1,
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 1024
                            },
                            "requireIsolated": {
                              "default": false,
                              "type": "boolean"
                            },
                            "kind": {
                              "type": "string",
                              "enum": [
                                "removeRequired",
                                "belowMinimum",
                                "aboveMaximum",
                                "shortenString",
                                "lengthenString",
                                "shortenArray",
                                "lengthenArray"
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "path",
                            "kind"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 1024
                            },
                            "requireIsolated": {
                              "default": false,
                              "type": "boolean"
                            },
                            "kind": {
                              "type": "string",
                              "const": "replaceType"
                            },
                            "replacementType": {
                              "type": "string",
                              "enum": [
                                "null",
                                "boolean",
                                "integer",
                                "number",
                                "string",
                                "array",
                                "object"
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "path",
                            "kind",
                            "replacementType"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 1024
                            },
                            "requireIsolated": {
                              "default": false,
                              "type": "boolean"
                            },
                            "kind": {
                              "type": "string",
                              "const": "outsideEnum"
                            },
                            "value": {
                              "anyOf": [
                                {
                                  "type": "null"
                                },
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "number"
                                },
                                {
                                  "type": "string",
                                  "maxLength": 1024
                                }
                              ]
                            }
                          },
                          "required": [
                            "id",
                            "path",
                            "kind",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "path": {
                              "type": "string",
                              "maxLength": 1024
                            },
                            "requireIsolated": {
                              "default": false,
                              "type": "boolean"
                            },
                            "kind": {
                              "type": "string",
                              "const": "addProperty"
                            },
                            "name": {
                              "type": "string",
                              "maxLength": 128
                            }
                          },
                          "required": [
                            "id",
                            "path",
                            "kind",
                            "name"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "schema",
                  "seed",
                  "mutations"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-contract-negative-cases/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-contract-negative-cases/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "schema": {
                  "type": "object",
                  "required": [
                    "count",
                    "mode"
                  ],
                  "properties": {
                    "count": {
                      "type": "integer",
                      "minimum": 1,
                      "maximum": 3
                    },
                    "mode": {
                      "type": "string",
                      "enum": [
                        "fast",
                        "safe"
                      ]
                    }
                  },
                  "additionalProperties": false
                },
                "seed": {
                  "count": 1,
                  "mode": "fast"
                },
                "mutations": [
                  {
                    "id": "missing",
                    "kind": "removeRequired",
                    "path": "/count",
                    "requireIsolated": true
                  },
                  {
                    "id": "small",
                    "kind": "belowMinimum",
                    "path": "/count",
                    "requireIsolated": true
                  },
                  {
                    "id": "large",
                    "kind": "aboveMaximum",
                    "path": "/count",
                    "requireIsolated": true
                  },
                  {
                    "id": "enum",
                    "kind": "outsideEnum",
                    "path": "/mode",
                    "value": "other",
                    "requireIsolated": true
                  },
                  {
                    "id": "extra",
                    "kind": "addProperty",
                    "path": "",
                    "name": "extra",
                    "requireIsolated": true
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-contract-negative-cases",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "constructive-json-schema-v1"
                        },
                        "status": {
                          "type": "string",
                          "const": "complete"
                        },
                        "cases": {
                          "maxItems": 64,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string",
                                "enum": [
                                  "generated",
                                  "unavailable"
                                ]
                              },
                              "value": {
                                "$ref": "#/paths/~1v1~1mpp~1json-contract-negative-cases/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              },
                              "patch": {
                                "anyOf": [
                                  {
                                    "oneOf": [
                                      {
                                        "type": "object",
                                        "properties": {
                                          "op": {
                                            "type": "string",
                                            "const": "remove"
                                          },
                                          "path": {
                                            "type": "string"
                                          }
                                        },
                                        "required": [
                                          "op",
                                          "path"
                                        ],
                                        "additionalProperties": false
                                      },
                                      {
                                        "type": "object",
                                        "properties": {
                                          "op": {
                                            "type": "string",
                                            "enum": [
                                              "add",
                                              "replace"
                                            ]
                                          },
                                          "path": {
                                            "type": "string"
                                          },
                                          "value": {
                                            "$ref": "#/paths/~1v1~1mpp~1json-contract-negative-cases/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                          }
                                        },
                                        "required": [
                                          "op",
                                          "path",
                                          "value"
                                        ],
                                        "additionalProperties": false
                                      }
                                    ]
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "target": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "keyword": {
                                        "type": "string",
                                        "enum": [
                                          "type",
                                          "const",
                                          "enum",
                                          "minimum",
                                          "maximum",
                                          "minLength",
                                          "maxLength",
                                          "minItems",
                                          "maxItems",
                                          "required",
                                          "additionalProperties"
                                        ]
                                      },
                                      "schemaPath": {
                                        "type": "string"
                                      },
                                      "instancePath": {
                                        "type": "string"
                                      },
                                      "property": {
                                        "type": [
                                          "string",
                                          "null"
                                        ]
                                      }
                                    },
                                    "required": [
                                      "keyword",
                                      "schemaPath",
                                      "instancePath",
                                      "property"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "failures": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "keyword": {
                                      "type": "string",
                                      "enum": [
                                        "type",
                                        "const",
                                        "enum",
                                        "minimum",
                                        "maximum",
                                        "minLength",
                                        "maxLength",
                                        "minItems",
                                        "maxItems",
                                        "required",
                                        "additionalProperties"
                                      ]
                                    },
                                    "schemaPath": {
                                      "type": "string"
                                    },
                                    "instancePath": {
                                      "type": "string"
                                    },
                                    "property": {
                                      "type": [
                                        "string",
                                        "null"
                                      ]
                                    }
                                  },
                                  "required": [
                                    "keyword",
                                    "schemaPath",
                                    "instancePath",
                                    "property"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "isolated": {
                                "type": [
                                  "boolean",
                                  "null"
                                ]
                              },
                              "reason": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              }
                            },
                            "required": [
                              "id",
                              "kind",
                              "status",
                              "patch",
                              "target",
                              "failures",
                              "isolated",
                              "reason"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "testing": {
                          "type": "object",
                          "properties": {
                            "targetExecuted": {
                              "type": "boolean",
                              "const": false
                            },
                            "behaviorVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "fullInputSpaceCoverage": {
                              "type": "boolean",
                              "const": false
                            }
                          },
                          "required": [
                            "targetExecuted",
                            "behaviorVerified",
                            "fullInputSpaceCoverage"
                          ],
                          "additionalProperties": false
                        },
                        "metrics": {
                          "type": "object",
                          "properties": {
                            "schemaNodes": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            },
                            "validatorNodeVisits": {
                              "type": "integer",
                              "minimum": -9007199254740991,
                              "maximum": 9007199254740991
                            }
                          },
                          "required": [
                            "schemaNodes",
                            "validatorNodeVisits"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "profile",
                        "status",
                        "cases",
                        "testing",
                        "metrics"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1json-contract-negative-cases/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1json-contract-negative-cases/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-contract-negative-cases",
                  "version": "0.29.0",
                  "result": {
                    "profile": "constructive-json-schema-v1",
                    "status": "complete",
                    "cases": [
                      {
                        "id": "missing",
                        "kind": "removeRequired",
                        "status": "generated",
                        "value": {
                          "mode": "fast"
                        },
                        "patch": {
                          "op": "remove",
                          "path": "/count"
                        },
                        "target": {
                          "keyword": "required",
                          "schemaPath": "/required/0",
                          "instancePath": "",
                          "property": "count"
                        },
                        "failures": [
                          {
                            "keyword": "required",
                            "schemaPath": "/required/0",
                            "instancePath": "",
                            "property": "count"
                          }
                        ],
                        "isolated": true,
                        "reason": null
                      },
                      {
                        "id": "small",
                        "kind": "belowMinimum",
                        "status": "generated",
                        "value": {
                          "count": 0,
                          "mode": "fast"
                        },
                        "patch": {
                          "op": "replace",
                          "path": "/count",
                          "value": 0
                        },
                        "target": {
                          "keyword": "minimum",
                          "schemaPath": "/properties/count/minimum",
                          "instancePath": "/count",
                          "property": null
                        },
                        "failures": [
                          {
                            "keyword": "minimum",
                            "schemaPath": "/properties/count/minimum",
                            "instancePath": "/count",
                            "property": null
                          }
                        ],
                        "isolated": true,
                        "reason": null
                      },
                      {
                        "id": "large",
                        "kind": "aboveMaximum",
                        "status": "generated",
                        "value": {
                          "count": 4,
                          "mode": "fast"
                        },
                        "patch": {
                          "op": "replace",
                          "path": "/count",
                          "value": 4
                        },
                        "target": {
                          "keyword": "maximum",
                          "schemaPath": "/properties/count/maximum",
                          "instancePath": "/count",
                          "property": null
                        },
                        "failures": [
                          {
                            "keyword": "maximum",
                            "schemaPath": "/properties/count/maximum",
                            "instancePath": "/count",
                            "property": null
                          }
                        ],
                        "isolated": true,
                        "reason": null
                      },
                      {
                        "id": "enum",
                        "kind": "outsideEnum",
                        "status": "generated",
                        "value": {
                          "count": 1,
                          "mode": "other"
                        },
                        "patch": {
                          "op": "replace",
                          "path": "/mode",
                          "value": "other"
                        },
                        "target": {
                          "keyword": "enum",
                          "schemaPath": "/properties/mode/enum",
                          "instancePath": "/mode",
                          "property": null
                        },
                        "failures": [
                          {
                            "keyword": "enum",
                            "schemaPath": "/properties/mode/enum",
                            "instancePath": "/mode",
                            "property": null
                          }
                        ],
                        "isolated": true,
                        "reason": null
                      },
                      {
                        "id": "extra",
                        "kind": "addProperty",
                        "status": "generated",
                        "value": {
                          "count": 1,
                          "mode": "fast",
                          "extra": null
                        },
                        "patch": {
                          "op": "add",
                          "path": "/extra",
                          "value": null
                        },
                        "target": {
                          "keyword": "additionalProperties",
                          "schemaPath": "/additionalProperties",
                          "instancePath": "",
                          "property": "extra"
                        },
                        "failures": [
                          {
                            "keyword": "additionalProperties",
                            "schemaPath": "/additionalProperties",
                            "instancePath": "",
                            "property": "extra"
                          }
                        ],
                        "isolated": true,
                        "reason": null
                      }
                    ],
                    "testing": {
                      "targetExecuted": false,
                      "behaviorVerified": false,
                      "fullInputSpaceCoverage": false
                    },
                    "metrics": {
                      "schemaNodes": 3,
                      "validatorNodeVisits": 17
                    }
                  },
                  "provenance": {
                    "inputSha256": "92b1781c5d4fb22662c0f3b12949608d22c2d3049848b4f4578d94b179aebd08",
                    "outputSha256": "c7d676c4af4f285bf4b45d99110910f7d394a6bdf6c8490543577d7cc0651ac9",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/cbor-typed-codec": {
      "post": {
        "operationId": "mpp_cbor_typed_codec",
        "summary": "Typed deterministic CBOR codec",
        "description": "Encode typed values or decode a strictly admitted core-deterministic CBOR integer subset with bounded tokens and exact integer precision.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/cbor-typed-codec.md"
        },
        "x-agent-discovery": {
          "intents": [
            "encode deterministic CBOR",
            "decode typed CBOR",
            "preserve exact CBOR integers and bytes",
            "inspect bounded core deterministic CBOR"
          ],
          "whenToUse": [
            "A declared consumer requires this specific binary format and exact integer/binary distinctions",
            "Create a bounded offline configuration or protocol fixture from supplied typed values"
          ],
          "whenNotToUse": [
            "Floating point, dates, timestamp/tag extensions, missing-value primitives, custom objects, streaming or arbitrary maps",
            "General CBOR, tags, indefinite lengths, unsorted keys or nonpreferred encodings",
            "Legacy length-first CBOR map ordering or dCBOR normalization",
            "Network transport, authentication, signatures, COSE/CWT/WebAuthn, consumer schema validation, or execution of decoded content"
          ],
          "capabilities": [
            "Canonical decimal input strings preserve the full profile integer domain",
            "Unicode scalar text and strict canonical standard padded base64",
            "Duplicate typed keys rejected; text and byte strings remain distinct",
            "Complete semantic computation and result admission before payment challenge and again during execution",
            "Networkless deterministic supplied-input-only artifacts; externalRequests=0",
            "RFC 8949 core bytewise key order; lazy upstream tokens with budgets before materialization, exact one-item consumption and byte-equality re-encoding"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "jsonDepth": 20,
            "wireBytes": 40000,
            "contentBytes": 32768,
            "valueNodes": 1024,
            "arrayItems": 512,
            "mapPairs": 128,
            "valueDepth": 5,
            "cborKeyBytes": 128,
            "messagepackKeyBytes": 64,
            "profile": "cbor-core-deterministic-integer-v1",
            "actions": "encode,decode",
            "integerMinimum": "-18446744073709551616",
            "integerMaximum": "18446744073709551615",
            "mapKeys": "Typed integers or scalar text <=128 UTF-8 bytes; reserved text names rejected",
            "determinismScope": "RFC8949-core-subset"
          },
          "related": [
            "messagepack-compose",
            "protobuf-message-compose",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INTEGER",
            "INTEGER_RANGE",
            "INVALID_KEY",
            "DUPLICATE_KEY",
            "INVALID_ENCODING",
            "UNSUPPORTED_TYPE",
            "NONDETERMINISTIC_ENCODING",
            "ENCODING_MISMATCH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "action": {
                        "type": "string",
                        "const": "encode"
                      },
                      "value": {
                        "$ref": "#/paths/~1v1~1mpp~1cbor-typed-codec/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    },
                    "required": [
                      "action",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "object",
                    "properties": {
                      "action": {
                        "type": "string",
                        "const": "decode"
                      },
                      "base64": {
                        "type": "string",
                        "maxLength": 53336
                      }
                    },
                    "required": [
                      "action",
                      "base64"
                    ],
                    "additionalProperties": false
                  }
                ],
                "$defs": {
                  "__schema0": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "null"
                          }
                        },
                        "required": [
                          "type"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "boolean"
                          },
                          "value": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "integer"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 21
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "text"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 32768
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "bytes"
                          },
                          "base64": {
                            "type": "string",
                            "maxLength": 43692
                          }
                        },
                        "required": [
                          "type",
                          "base64"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "array"
                          },
                          "items": {
                            "maxItems": 512,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1mpp~1cbor-typed-codec/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          }
                        },
                        "required": [
                          "type",
                          "items"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "map"
                          },
                          "entries": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "integer"
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 21
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "text"
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 32768
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  ]
                                },
                                "value": {
                                  "$ref": "#/paths/~1v1~1mpp~1cbor-typed-codec/post/requestBody/content/application~1json/schema/$defs/__schema0"
                                }
                              },
                              "required": [
                                "key",
                                "value"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "type",
                          "entries"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                }
              },
              "example": {
                "action": "encode",
                "value": {
                  "type": "map",
                  "entries": [
                    {
                      "key": {
                        "type": "integer",
                        "value": "24"
                      },
                      "value": {
                        "type": "text",
                        "value": "x"
                      }
                    },
                    {
                      "key": {
                        "type": "integer",
                        "value": "-1"
                      },
                      "value": {
                        "type": "text",
                        "value": "y"
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "cbor-typed-codec",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "cbor-core-deterministic-integer-v1"
                            },
                            "action": {
                              "type": "string",
                              "const": "encode"
                            },
                            "base64": {
                              "type": "string",
                              "maxLength": 53336
                            },
                            "byteLength": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 40000
                            },
                            "valueCount": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 1024
                            },
                            "maxValueDepth": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 5
                            },
                            "deterministic": {
                              "type": "boolean",
                              "const": true
                            }
                          },
                          "required": [
                            "profile",
                            "action",
                            "base64",
                            "byteLength",
                            "valueCount",
                            "maxValueDepth",
                            "deterministic"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "cbor-core-deterministic-integer-v1"
                            },
                            "action": {
                              "type": "string",
                              "const": "decode"
                            },
                            "value": {
                              "$ref": "#/paths/~1v1~1mpp~1cbor-typed-codec/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                            },
                            "byteLength": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 40000
                            },
                            "valueCount": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 1024
                            },
                            "maxValueDepth": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 5
                            },
                            "deterministic": {
                              "type": "boolean",
                              "const": true
                            }
                          },
                          "required": [
                            "profile",
                            "action",
                            "value",
                            "byteLength",
                            "valueCount",
                            "maxValueDepth",
                            "deterministic"
                          ],
                          "additionalProperties": false
                        }
                      ],
                      "$defs": {
                        "__schema0": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "null"
                                }
                              },
                              "required": [
                                "type"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "boolean"
                                },
                                "value": {
                                  "type": "boolean"
                                }
                              },
                              "required": [
                                "type",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "integer"
                                },
                                "value": {
                                  "type": "string",
                                  "maxLength": 21
                                }
                              },
                              "required": [
                                "type",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "text"
                                },
                                "value": {
                                  "type": "string",
                                  "maxLength": 32768
                                }
                              },
                              "required": [
                                "type",
                                "value"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "bytes"
                                },
                                "base64": {
                                  "type": "string",
                                  "maxLength": 43692
                                }
                              },
                              "required": [
                                "type",
                                "base64"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "array"
                                },
                                "items": {
                                  "maxItems": 512,
                                  "type": "array",
                                  "items": {
                                    "$ref": "#/paths/~1v1~1mpp~1cbor-typed-codec/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                }
                              },
                              "required": [
                                "type",
                                "items"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "map"
                                },
                                "entries": {
                                  "maxItems": 128,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "key": {
                                        "oneOf": [
                                          {
                                            "type": "object",
                                            "properties": {
                                              "type": {
                                                "type": "string",
                                                "const": "integer"
                                              },
                                              "value": {
                                                "type": "string",
                                                "maxLength": 21
                                              }
                                            },
                                            "required": [
                                              "type",
                                              "value"
                                            ],
                                            "additionalProperties": false
                                          },
                                          {
                                            "type": "object",
                                            "properties": {
                                              "type": {
                                                "type": "string",
                                                "const": "text"
                                              },
                                              "value": {
                                                "type": "string",
                                                "maxLength": 32768
                                              }
                                            },
                                            "required": [
                                              "type",
                                              "value"
                                            ],
                                            "additionalProperties": false
                                          }
                                        ]
                                      },
                                      "value": {
                                        "$ref": "#/paths/~1v1~1mpp~1cbor-typed-codec/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                      }
                                    },
                                    "required": [
                                      "key",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  }
                                }
                              },
                              "required": [
                                "type",
                                "entries"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "cbor-typed-codec",
                  "version": "0.29.0",
                  "result": {
                    "profile": "cbor-core-deterministic-integer-v1",
                    "action": "encode",
                    "base64": "ohgYYXggYXk=",
                    "byteLength": 8,
                    "valueCount": 5,
                    "maxValueDepth": 1,
                    "deterministic": true
                  },
                  "provenance": {
                    "inputSha256": "7b9af4d66effddb96c02ddd45a9d116696f260b408666efb5c2359edfca7a086",
                    "outputSha256": "4178363f71c33a301c6ad2e9d333d706e7ddcd0a1a772cd6f1a9fa8e7b559ee1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/messagepack-compose": {
      "post": {
        "operationId": "mpp_messagepack_compose",
        "summary": "Typed MessagePack composer",
        "description": "Compose stable MessagePack bytes from typed integers, text, binary, arrays and restricted-key maps; exact uint64/int64, encode only.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/messagepack-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compose typed MessagePack",
            "encode exact int64 uint64 MessagePack",
            "create MessagePack binary record",
            "serialize typed binary payload"
          ],
          "whenToUse": [
            "A declared consumer requires this specific binary format and exact integer/binary distinctions",
            "Create a bounded offline configuration or protocol fixture from supplied typed values"
          ],
          "whenNotToUse": [
            "Floating point, dates, timestamp/tag extensions, missing-value primitives, custom objects, streaming or arbitrary maps",
            "Decode or inspect MessagePack bytes; decoding is explicitly held",
            "A universal MessagePack canonical form",
            "Network transport, authentication, signatures, COSE/CWT/WebAuthn, consumer schema validation, or execution of decoded content"
          ],
          "capabilities": [
            "Canonical decimal input strings preserve the full profile integer domain",
            "Unicode scalar text and strict canonical standard padded base64",
            "Duplicate typed keys rejected; text and byte strings remain distinct",
            "Complete semantic computation and result admission before payment challenge and again during execution",
            "Networkless deterministic supplied-input-only artifacts; externalRequests=0",
            "Service-defined stable ASCII-key ordering and shortest admitted wire forms; encode only"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "jsonDepth": 20,
            "wireBytes": 40000,
            "contentBytes": 32768,
            "valueNodes": 1024,
            "arrayItems": 512,
            "mapPairs": 128,
            "valueDepth": 5,
            "cborKeyBytes": 128,
            "messagepackKeyBytes": 64,
            "profile": "messagepack-stable-integer-v1",
            "actions": "encode",
            "integerMinimum": "-9223372036854775808",
            "integerMaximum": "18446744073709551615",
            "mapKeys": "ASCII text [A-Za-z_][A-Za-z0-9_.-]{0,63}; reserved names rejected",
            "determinismScope": "this-profile-only"
          },
          "related": [
            "cbor-typed-codec",
            "protobuf-message-compose",
            "zip-store-compose"
          ],
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INTEGER",
            "INTEGER_RANGE",
            "INVALID_KEY",
            "DUPLICATE_KEY",
            "INVALID_ENCODING",
            "UNSUPPORTED_TYPE",
            "NONDETERMINISTIC_ENCODING",
            "ENCODING_MISMATCH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string",
                    "const": "encode"
                  },
                  "value": {
                    "$ref": "#/paths/~1v1~1mpp~1messagepack-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                  }
                },
                "required": [
                  "action",
                  "value"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "null"
                          }
                        },
                        "required": [
                          "type"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "boolean"
                          },
                          "value": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "integer"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 21
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "text"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 32768
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "bytes"
                          },
                          "base64": {
                            "type": "string",
                            "maxLength": 43692
                          }
                        },
                        "required": [
                          "type",
                          "base64"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "array"
                          },
                          "items": {
                            "maxItems": 512,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1mpp~1messagepack-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                            }
                          }
                        },
                        "required": [
                          "type",
                          "items"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "map"
                          },
                          "entries": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "key": {
                                  "oneOf": [
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "integer"
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 21
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    },
                                    {
                                      "type": "object",
                                      "properties": {
                                        "type": {
                                          "type": "string",
                                          "const": "text"
                                        },
                                        "value": {
                                          "type": "string",
                                          "maxLength": 32768
                                        }
                                      },
                                      "required": [
                                        "type",
                                        "value"
                                      ],
                                      "additionalProperties": false
                                    }
                                  ]
                                },
                                "value": {
                                  "$ref": "#/paths/~1v1~1mpp~1messagepack-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                                }
                              },
                              "required": [
                                "key",
                                "value"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "type",
                          "entries"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  }
                }
              },
              "example": {
                "action": "encode",
                "value": {
                  "type": "map",
                  "entries": [
                    {
                      "key": {
                        "type": "text",
                        "value": "id"
                      },
                      "value": {
                        "type": "integer",
                        "value": "18446744073709551615"
                      }
                    },
                    {
                      "key": {
                        "type": "text",
                        "value": "blob"
                      },
                      "value": {
                        "type": "bytes",
                        "base64": "AP8="
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "messagepack-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "messagepack-stable-integer-v1"
                        },
                        "action": {
                          "type": "string",
                          "const": "encode"
                        },
                        "base64": {
                          "type": "string",
                          "maxLength": 53336
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 40000
                        },
                        "valueCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 1024
                        },
                        "maxValueDepth": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 5
                        },
                        "determinismScope": {
                          "type": "string",
                          "const": "this-profile-only"
                        }
                      },
                      "required": [
                        "profile",
                        "action",
                        "base64",
                        "byteLength",
                        "valueCount",
                        "maxValueDepth",
                        "determinismScope"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "messagepack-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "messagepack-stable-integer-v1",
                    "action": "encode",
                    "base64": "gqRibG9ixAIA/6JpZM///////////w==",
                    "byteLength": 22,
                    "valueCount": 5,
                    "maxValueDepth": 1,
                    "determinismScope": "this-profile-only"
                  },
                  "provenance": {
                    "inputSha256": "a4ad025cad1b5ebe3f64d20dac6c26256b62901557a7a6b725a6f08919914302",
                    "outputSha256": "d3c9928e42a45e1b8a879ed97400b790571dc529da0d3a483f238db6067743f4",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/toml-config-compose": {
      "post": {
        "operationId": "mpp_toml_config_compose",
        "summary": "Typed TOML configuration composer",
        "description": "Compose deterministic TOML 1.0-compatible configuration from explicit string, signed-int64, boolean and homogeneous-array declarations; preserve integer precision and detect table conflicts.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/toml-config-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compose typed TOML configuration",
            "generate TOML with exact int64 values",
            "serialize homogeneous arrays and nested TOML tables",
            "detect TOML table scalar conflicts"
          ],
          "whenToUse": [
            "Creating new TOML 1.0-compatible files from explicit typed declarations",
            "Preserving full signed-int64 precision without JavaScript numeric conversion",
            "Producing an inert exact-byte configuration artifact for an offline consumer"
          ],
          "whenNotToUse": [
            "Parsing, merging or editing existing TOML source or preserving comments",
            "Floating-point values, dates, times, null, nested or mixed arrays, arrays of tables or inline tables",
            "Application configuration validation, interpolation, environment expansion, filesystem includes or secret classification",
            "Network requests, writing files, live configuration changes, authentication, publishing or deployment"
          ],
          "capabilities": [
            "Profile toml-1.0-typed-config-v1; quoted basic-string keys; UTF-16 ordinal ordering with parents first",
            "Signed-int64 decimal strings; typed homogeneous primitive arrays; Unicode scalar strings",
            "Duplicate table/key and scalar/table-ancestor conflict rejection; exact key segments including literal dots",
            "LF line endings and final LF for nonempty output; empty root produces the empty document",
            "Deterministic supplied-input-only artifact; no network, clock or randomness",
            "Exact artifact UTF-8 byte lengths and SHA-256 hashes"
          ],
          "related": [
            "zip-store-compose",
            "json-schema-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 20,
            "tables": 128,
            "entries": 512,
            "tablePathSegments": 4,
            "keyUtf8Bytes": 128,
            "arrayCells": 256,
            "aggregateCells": 2048,
            "stringValueUtf8Bytes": 32768,
            "artifactUtf8Bytes": 100000,
            "profile": "toml-1.0-typed-config-v1"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "INVALID_INPUT",
            "UNSAFE_KEY",
            "TOML_INTEGER",
            "TOML_KEY_LIMIT",
            "TOML_DUPLICATE_TABLE",
            "TOML_ENTRY_LIMIT",
            "TOML_CELL_LIMIT",
            "TOML_ARRAY_TYPE",
            "TOML_STRING_LIMIT",
            "TOML_DUPLICATE_KEY",
            "TOML_TABLE_CONFLICT",
            "TOML_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "tables": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 128
                          }
                        },
                        "entries": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string",
                                "maxLength": 128
                              },
                              "value": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "string"
                                      },
                                      "value": {
                                        "type": "string",
                                        "maxLength": 32768
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "integer"
                                      },
                                      "value": {
                                        "type": "string",
                                        "maxLength": 20
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "boolean"
                                      },
                                      "value": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "value"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "type": {
                                        "type": "string",
                                        "const": "array"
                                      },
                                      "elementType": {
                                        "type": "string",
                                        "enum": [
                                          "string",
                                          "integer",
                                          "boolean"
                                        ]
                                      },
                                      "values": {
                                        "maxItems": 256,
                                        "type": "array",
                                        "items": {
                                          "anyOf": [
                                            {
                                              "type": "string",
                                              "maxLength": 32768
                                            },
                                            {
                                              "type": "boolean"
                                            }
                                          ]
                                        }
                                      }
                                    },
                                    "required": [
                                      "type",
                                      "elementType",
                                      "values"
                                    ],
                                    "additionalProperties": false
                                  }
                                ]
                              }
                            },
                            "required": [
                              "key",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "path",
                        "entries"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "tables"
                ],
                "additionalProperties": false
              },
              "example": {
                "tables": [
                  {
                    "path": [
                      "server"
                    ],
                    "entries": [
                      {
                        "key": "port",
                        "value": {
                          "type": "integer",
                          "value": "8080"
                        }
                      },
                      {
                        "key": "enabled",
                        "value": {
                          "type": "boolean",
                          "value": true
                        }
                      },
                      {
                        "key": "name",
                        "value": {
                          "type": "string",
                          "value": "café"
                        }
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "toml-config-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "toml-1.0-typed-config-v1"
                        },
                        "text": {
                          "type": "string",
                          "maxLength": 100000
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 100000
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "tableCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 128
                        },
                        "entryCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 512
                        }
                      },
                      "required": [
                        "profile",
                        "text",
                        "byteLength",
                        "sha256",
                        "tableCount",
                        "entryCount"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "toml-config-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "toml-1.0-typed-config-v1",
                    "text": "[\"server\"]\n\"enabled\" = true\n\"name\" = \"café\"\n\"port\" = 8080\n",
                    "byteLength": 59,
                    "sha256": "87bc7526e622cadc468e1870a97859ccc52909d2419e07064af6162e22a99d35",
                    "tableCount": 1,
                    "entryCount": 3
                  },
                  "provenance": {
                    "inputSha256": "fe94f7a66d0e2d6a9ea149fd1123d7e3673ab90b272e1a4b855a7683f273e4da",
                    "outputSha256": "050fb9b266805cf67ae8e4a0d458b3b89cd5424fe22ae1e866475934ef7d3f6f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/http-structured-fields-compose": {
      "post": {
        "operationId": "mpp_http_structured_fields_compose",
        "summary": "Typed HTTP structured-field composer",
        "description": "Compose separate exact RFC 8941-compatible structured field values from explicit typed Items, Lists and Dictionaries; preserve decimal types without floating-point rounding.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-structured-fields-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compose typed HTTP structured fields",
            "serialize RFC 8941 items lists dictionaries",
            "preserve HTTP structured decimal and integer distinction",
            "prepare offline structured header field fixtures"
          ],
          "whenToUse": [
            "Composing caller-declared structured field name/value pairs for offline protocol fixtures",
            "Preserving ordered dictionaries and parameters with explicit string/token/bytes/integer/decimal/boolean types",
            "Rejecting decimal rounding, injection and duplicate keys before handoff"
          ],
          "whenNotToUse": [
            "Parsing existing fields, combining repeated lines or normalizing arbitrary headers",
            "Full RFC 9651 Date and Display String types; this explicit RFC 8941 vocabulary profile excludes them",
            "HTTP Message Signatures, signing, digest verification, authentication, cookies, header policy or application field semantics",
            "Raw HTTP header blocks, requests or transmission",
            "Network requests, writing files, live configuration changes, authentication, publishing or deployment"
          ],
          "capabilities": [
            "Profile http-sf-rfc8941-compose-v1; RFC 9651 supersedes RFC 8941 without silently expanding this vocabulary",
            "Exact decimal-string formatting without rounding; signed zero normalized within its selected integer or decimal type",
            "Preserved field, dictionary and parameter order; boolean-true elision; padded canonical base64",
            "Empty List/Dictionary returns omitted true and null value/hash; caller must omit that field",
            "Deterministic supplied-input-only artifact; no network, clock or randomness",
            "Exact artifact UTF-8 byte lengths and SHA-256 hashes"
          ],
          "related": [
            "content-digest",
            "json-schema-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 20,
            "fields": 16,
            "fieldValueBytes": 8192,
            "totalValueBytes": 16384,
            "topLevelMembers": 128,
            "innerListItems": 32,
            "parameters": 16,
            "bareItems": 512,
            "keyAsciiBytes": 64,
            "tokenBytes": 256,
            "stringBytes": 1024,
            "decodedByteValueBytes": 2048,
            "profile": "http-sf-rfc8941-compose-v1"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "INVALID_INPUT",
            "UNSAFE_KEY",
            "SF_KEY",
            "SF_ITEM_LIMIT",
            "SF_INTEGER",
            "SF_DECIMAL",
            "SF_STRING",
            "SF_TOKEN",
            "SF_BYTES",
            "SF_BYTES_LIMIT",
            "SF_DUPLICATE_KEY",
            "SF_FIELD_NAME",
            "SF_DUPLICATE_FIELD",
            "SF_FIELD_LIMIT",
            "SF_TOTAL_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "fields": {
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema0"
                    }
                  }
                },
                "required": [
                  "fields"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          },
                          "kind": {
                            "type": "string",
                            "const": "item"
                          },
                          "value": {
                            "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema1"
                          }
                        },
                        "required": [
                          "name",
                          "kind",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          },
                          "kind": {
                            "type": "string",
                            "const": "list"
                          },
                          "value": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema5"
                            }
                          }
                        },
                        "required": [
                          "name",
                          "kind",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          },
                          "kind": {
                            "type": "string",
                            "const": "dictionary"
                          },
                          "value": {
                            "maxItems": 128,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema6"
                            }
                          }
                        },
                        "required": [
                          "name",
                          "kind",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "__schema1": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "const": "item"
                      },
                      "value": {
                        "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema2"
                      },
                      "parameters": {
                        "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema3"
                      }
                    },
                    "required": [
                      "kind",
                      "value",
                      "parameters"
                    ],
                    "additionalProperties": false
                  },
                  "__schema2": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "integer"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 16
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "decimal"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 17
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "string"
                          },
                          "value": {
                            "type": "string",
                            "maxLength": 1024
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "token"
                          },
                          "value": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 256
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "bytes"
                          },
                          "base64": {
                            "type": "string",
                            "maxLength": 2732
                          }
                        },
                        "required": [
                          "type",
                          "base64"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "const": "boolean"
                          },
                          "value": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "type",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "__schema3": {
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema4"
                    }
                  },
                  "__schema4": {
                    "type": "object",
                    "properties": {
                      "key": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 64
                      },
                      "value": {
                        "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema2"
                      }
                    },
                    "required": [
                      "key",
                      "value"
                    ],
                    "additionalProperties": false
                  },
                  "__schema5": {
                    "anyOf": [
                      {
                        "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema1"
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "inner-list"
                          },
                          "items": {
                            "maxItems": 32,
                            "type": "array",
                            "items": {
                              "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema1"
                            }
                          },
                          "parameters": {
                            "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema3"
                          }
                        },
                        "required": [
                          "kind",
                          "items",
                          "parameters"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "__schema6": {
                    "type": "object",
                    "properties": {
                      "key": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 64
                      },
                      "value": {
                        "$ref": "#/paths/~1v1~1mpp~1http-structured-fields-compose/post/requestBody/content/application~1json/schema/$defs/__schema5"
                      }
                    },
                    "required": [
                      "key",
                      "value"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "example": {
                "fields": [
                  {
                    "name": "example-field",
                    "kind": "dictionary",
                    "value": [
                      {
                        "key": "demo",
                        "value": {
                          "kind": "inner-list",
                          "items": [
                            {
                              "kind": "item",
                              "value": {
                                "type": "string",
                                "value": "@method"
                              },
                              "parameters": []
                            },
                            {
                              "kind": "item",
                              "value": {
                                "type": "string",
                                "value": "@path"
                              },
                              "parameters": []
                            }
                          ],
                          "parameters": [
                            {
                              "key": "created",
                              "value": {
                                "type": "integer",
                                "value": "1700000000"
                              }
                            },
                            {
                              "key": "keyid",
                              "value": {
                                "type": "string",
                                "value": "test-key"
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-structured-fields-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-sf-rfc8941-compose-v1"
                        },
                        "fields": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "item",
                                  "list",
                                  "dictionary"
                                ]
                              },
                              "value": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 8192
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "byteLength": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8192
                              },
                              "sha256": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "pattern": "^[a-f0-9]{64}$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "omitted": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "name",
                              "kind",
                              "value",
                              "byteLength",
                              "sha256",
                              "omitted"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "totalValueBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 16384
                        }
                      },
                      "required": [
                        "profile",
                        "fields",
                        "totalValueBytes"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-structured-fields-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-sf-rfc8941-compose-v1",
                    "fields": [
                      {
                        "name": "example-field",
                        "kind": "dictionary",
                        "value": "demo=(\"@method\" \"@path\");created=1700000000;keyid=\"test-key\"",
                        "byteLength": 60,
                        "sha256": "9549594186c7d71f2acc27b9af7465a6e8702825b92cc5d7a196a689a83f256a",
                        "omitted": false
                      }
                    ],
                    "totalValueBytes": 60
                  },
                  "provenance": {
                    "inputSha256": "cb932c2bbf36d20dfa385ebc42387e41d8319f351e288e39c4a77589a100fd87",
                    "outputSha256": "6dbcf72ffb8b18b3d6fdc44a3a79541f0f2b2134575242028789cb33f8823e8f",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.003",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-sample-shape-infer": {
      "post": {
        "operationId": "mpp_json_sample_shape_infer",
        "summary": "Observed JSON sample shapes",
        "description": "Build an optional, open observational JSON Schema draft and counted evidence from supplied JSON samples; never infer a real API contract.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-sample-shape-infer.md"
        },
        "x-agent-discovery": {
          "intents": [
            "infer observational schema from JSON samples",
            "draft sampled JSON structure",
            "count recursive observed types"
          ],
          "whenToUse": [
            "Review a recursive open schema draft inferred from bounded supplied examples",
            "Inspect sample counts, optional properties and unobserved empty-array items"
          ],
          "whenNotToUse": [
            "Establishing a universal API contract or production rejection policy",
            "Inferring required fields, enums, formats, ranges, cross-field correlations or compatibility",
            "Generating a tool definition or assuming generalized fixture-generator compatibility",
            "Network access, filesystem changes, target execution, publishing or deployment"
          ],
          "capabilities": [
            "Fixed null, boolean, number, string, array, object union order using anyOf",
            "All observed numbers emit number; object properties stay optional and additionalProperties stays true",
            "Actual escaped schema pointers identify pooled observations; empty items emit true with zero counts",
            "No required, enum, const, bounds, patterns, formats, defaults, references or closed objects",
            "Pure supplied-input computation; complete bounded result admission before challenge; no external requests"
          ],
          "related": [
            "record-profile",
            "json-schema-check"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "samples": 64,
            "sourceNodes": 5000,
            "semanticDepth": 8,
            "pooledObjectKeys": 32,
            "observationLocations": 128,
            "emittedSchemaNodes": 180,
            "schemaValidationDepth": 16,
            "schemaRepresentationDepth": 20,
            "keyBytes": 96,
            "aggregateSourceKeyBytes": 64000,
            "aggregateSchemaPointerBytes": 32768,
            "nodeVisits": 5000
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "SHAPE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "samples": {
                    "minItems": 1,
                    "maxItems": 64,
                    "type": "array",
                    "items": {
                      "$ref": "#/paths/~1v1~1mpp~1json-sample-shape-infer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                    }
                  }
                },
                "required": [
                  "samples"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1json-sample-shape-infer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1json-sample-shape-infer/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "samples": [
                  {
                    "id": 1,
                    "tag": "a",
                    "tags": []
                  },
                  {
                    "id": 2,
                    "tag": null,
                    "tags": [
                      "x"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-sample-shape-infer",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "observed-json-shapes-v1"
                        },
                        "evidence": {
                          "type": "string",
                          "const": "observed-structure-only"
                        },
                        "contractEstablished": {
                          "type": "boolean",
                          "const": false
                        },
                        "sampleCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 64
                        },
                        "dialect": {
                          "type": "string",
                          "const": "https://json-schema.org/draft/2020-12/schema"
                        },
                        "schema": {
                          "$ref": "#/paths/~1v1~1mpp~1json-sample-shape-infer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                        },
                        "observations": {
                          "minItems": 1,
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "schemaPointer": {
                                "type": "string",
                                "maxLength": 4096
                              },
                              "occurrences": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 5000
                              },
                              "typeCounts": {
                                "maxItems": 6,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "enum": [
                                        "null",
                                        "boolean",
                                        "number",
                                        "string",
                                        "array",
                                        "object"
                                      ]
                                    },
                                    "count": {
                                      "type": "integer",
                                      "minimum": 1,
                                      "maximum": 5000
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "count"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "objectOccurrences": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 5000
                              },
                              "properties": {
                                "maxItems": 32,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "maxLength": 96
                                    },
                                    "presentCount": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 5000
                                    },
                                    "objectCount": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 5000
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "presentCount",
                                    "objectCount"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "elementOccurrences": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 5000
                              }
                            },
                            "required": [
                              "schemaPointer",
                              "occurrences",
                              "typeCounts"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "evidence",
                        "contractEstablished",
                        "sampleCount",
                        "dialect",
                        "schema",
                        "observations"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "boolean",
                              "const": true
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "null",
                                    "boolean",
                                    "number",
                                    "string"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "array"
                                },
                                "items": {
                                  "$ref": "#/paths/~1v1~1mpp~1json-sample-shape-infer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                }
                              },
                              "required": [
                                "type",
                                "items"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "const": "object"
                                },
                                "properties": {
                                  "type": "object",
                                  "propertyNames": {
                                    "type": "string"
                                  },
                                  "additionalProperties": {
                                    "$ref": "#/paths/~1v1~1mpp~1json-sample-shape-infer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                },
                                "additionalProperties": {
                                  "type": "boolean",
                                  "const": true
                                }
                              },
                              "required": [
                                "type",
                                "properties",
                                "additionalProperties"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "anyOf": {
                                  "minItems": 2,
                                  "maxItems": 6,
                                  "type": "array",
                                  "items": {
                                    "$ref": "#/paths/~1v1~1mpp~1json-sample-shape-infer/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                  }
                                }
                              },
                              "required": [
                                "anyOf"
                              ],
                              "additionalProperties": false
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-sample-shape-infer",
                  "version": "0.29.0",
                  "result": {
                    "profile": "observed-json-shapes-v1",
                    "evidence": "observed-structure-only",
                    "contractEstablished": false,
                    "sampleCount": 2,
                    "dialect": "https://json-schema.org/draft/2020-12/schema",
                    "schema": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "number"
                        },
                        "tag": {
                          "anyOf": [
                            {
                              "type": "null"
                            },
                            {
                              "type": "string"
                            }
                          ]
                        },
                        "tags": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "additionalProperties": true
                    },
                    "observations": [
                      {
                        "schemaPointer": "",
                        "occurrences": 2,
                        "typeCounts": [
                          {
                            "type": "object",
                            "count": 2
                          }
                        ],
                        "objectOccurrences": 2,
                        "properties": [
                          {
                            "name": "id",
                            "presentCount": 2,
                            "objectCount": 2
                          },
                          {
                            "name": "tag",
                            "presentCount": 2,
                            "objectCount": 2
                          },
                          {
                            "name": "tags",
                            "presentCount": 2,
                            "objectCount": 2
                          }
                        ]
                      },
                      {
                        "schemaPointer": "/properties/id",
                        "occurrences": 2,
                        "typeCounts": [
                          {
                            "type": "number",
                            "count": 2
                          }
                        ]
                      },
                      {
                        "schemaPointer": "/properties/tag",
                        "occurrences": 2,
                        "typeCounts": [
                          {
                            "type": "null",
                            "count": 1
                          },
                          {
                            "type": "string",
                            "count": 1
                          }
                        ]
                      },
                      {
                        "schemaPointer": "/properties/tags",
                        "occurrences": 2,
                        "typeCounts": [
                          {
                            "type": "array",
                            "count": 2
                          }
                        ],
                        "elementOccurrences": 1
                      },
                      {
                        "schemaPointer": "/properties/tags/items",
                        "occurrences": 1,
                        "typeCounts": [
                          {
                            "type": "string",
                            "count": 1
                          }
                        ]
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "cd6d60c9fe4a6bf4587ba834b28f344a6e856e95e517470ced05bb3f24dedeed",
                    "outputSha256": "f482c987df131aeecd8ca5571ce7edc472358b72167e0f4ca417278c34d7b52a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.004",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/structured-log-template-pack": {
      "post": {
        "operationId": "mpp_structured_log_template_pack",
        "summary": "Explicit scalar log templates",
        "description": "Factor supplied JSON log records into exact literal templates and typed caller-selected scalar occurrences, preserving parsed values and record order for client reconstruction.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/structured-log-template-pack.md"
        },
        "x-agent-discovery": {
          "intents": [
            "pack structured logs into reversible templates",
            "factor exact JSON log shapes",
            "extract caller-selected scalar log parameters"
          ],
          "whenToUse": [
            "Preserve every parsed JSON log value in exact literal templates and ordered occurrences",
            "Select scalar parameter pointers explicitly and reconstruct original records on the client"
          ],
          "whenNotToUse": [
            "Semantic log grouping, anomaly detection, root cause, severity or incident diagnosis",
            "Automatic timestamp, identifier, UUID, IP or secret detection and redaction",
            "Guaranteed compression, lower model token cost, authenticated history or safer sharing",
            "Preserving source member order, duplicate keys, numeric token spelling or pre-parse precision",
            "Network access, filesystem changes, target execution, publishing or deployment"
          ],
          "capabilities": [
            "Template equality includes every unselected literal, array order, present parameter pointers and scalar types",
            "Caller pointer order defines slots; first occurrence defines template indexes; record order is preserved",
            "Exact canonical structural keys distinguish null, absence, booleans, numbers and strings",
            "No automatic secret redaction: all original values remain in the artifact",
            "Pure supplied-input computation; complete bounded result admission before challenge; no external requests"
          ],
          "related": [
            "records-aggregate",
            "json-selector-redact"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "records": 256,
            "parameterPointers": 16,
            "sourceNodes": 6000,
            "semanticDepth": 8,
            "templates": 128,
            "extractedScalars": 4096,
            "aggregateCanonicalSkeletonBytes": 64000,
            "pointerBytes": 256,
            "pointerDepth": 8,
            "pointerTraversalSteps": 32768
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_POINTER",
            "OVERLAPPING_POINTERS",
            "UNSUPPORTED_TARGET",
            "LOG_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "minItems": 1,
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {
                        "$ref": "#/paths/~1v1~1mpp~1structured-log-template-pack/post/requestBody/content/application~1json/schema/$defs/__schema0"
                      }
                    }
                  },
                  "parameterPointers": {
                    "minItems": 1,
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 256
                    }
                  }
                },
                "required": [
                  "records",
                  "parameterPointers"
                ],
                "additionalProperties": false,
                "$defs": {
                  "__schema0": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      },
                      {
                        "type": "boolean"
                      },
                      {
                        "type": "null"
                      },
                      {
                        "type": "array",
                        "items": {
                          "$ref": "#/paths/~1v1~1mpp~1structured-log-template-pack/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      },
                      {
                        "type": "object",
                        "propertyNames": {
                          "type": "string"
                        },
                        "additionalProperties": {
                          "$ref": "#/paths/~1v1~1mpp~1structured-log-template-pack/post/requestBody/content/application~1json/schema/$defs/__schema0"
                        }
                      }
                    ]
                  }
                }
              },
              "example": {
                "records": [
                  {
                    "event": "download",
                    "job": "a",
                    "status": 200
                  },
                  {
                    "event": "download",
                    "job": "b",
                    "status": 200
                  },
                  {
                    "event": "download",
                    "job": "c",
                    "status": 500
                  }
                ],
                "parameterPointers": [
                  "/job"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "structured-log-template-pack",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "explicit-scalar-log-templates-v1"
                        },
                        "evidence": {
                          "type": "string",
                          "const": "literal-structure-only"
                        },
                        "reversibleParsedValues": {
                          "type": "boolean",
                          "const": true
                        },
                        "recordCount": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 256
                        },
                        "templateCounts": {
                          "minItems": 1,
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 256
                          }
                        },
                        "artifact": {
                          "type": "object",
                          "properties": {
                            "templates": {
                              "minItems": 1,
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "skeleton": {
                                    "type": "object",
                                    "propertyNames": {
                                      "type": "string"
                                    },
                                    "additionalProperties": {
                                      "$ref": "#/paths/~1v1~1mpp~1structured-log-template-pack/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                                    }
                                  },
                                  "parameters": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "pointer": {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 256
                                        },
                                        "type": {
                                          "type": "string",
                                          "enum": [
                                            "null",
                                            "boolean",
                                            "number",
                                            "string"
                                          ]
                                        }
                                      },
                                      "required": [
                                        "pointer",
                                        "type"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "skeleton",
                                  "parameters"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "occurrences": {
                              "minItems": 1,
                              "maxItems": 256,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "template": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 127
                                  },
                                  "values": {
                                    "maxItems": 16,
                                    "type": "array",
                                    "items": {
                                      "type": [
                                        "null",
                                        "boolean",
                                        "number",
                                        "string"
                                      ]
                                    }
                                  }
                                },
                                "required": [
                                  "template",
                                  "values"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "templates",
                            "occurrences"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "profile",
                        "evidence",
                        "reversibleParsedValues",
                        "recordCount",
                        "templateCounts",
                        "artifact"
                      ],
                      "additionalProperties": false,
                      "$defs": {
                        "__schema0": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "number"
                            },
                            {
                              "type": "boolean"
                            },
                            {
                              "type": "null"
                            },
                            {
                              "type": "array",
                              "items": {
                                "$ref": "#/paths/~1v1~1mpp~1structured-log-template-pack/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            },
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {
                                "$ref": "#/paths/~1v1~1mpp~1structured-log-template-pack/post/responses/200/content/application~1json/schema/properties/result/$defs/__schema0"
                              }
                            }
                          ]
                        }
                      }
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "structured-log-template-pack",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-scalar-log-templates-v1",
                    "evidence": "literal-structure-only",
                    "reversibleParsedValues": true,
                    "recordCount": 3,
                    "templateCounts": [
                      2,
                      1
                    ],
                    "artifact": {
                      "templates": [
                        {
                          "skeleton": {
                            "event": "download",
                            "job": null,
                            "status": 200
                          },
                          "parameters": [
                            {
                              "pointer": "/job",
                              "type": "string"
                            }
                          ]
                        },
                        {
                          "skeleton": {
                            "event": "download",
                            "job": null,
                            "status": 500
                          },
                          "parameters": [
                            {
                              "pointer": "/job",
                              "type": "string"
                            }
                          ]
                        }
                      ],
                      "occurrences": [
                        {
                          "template": 0,
                          "values": [
                            "a"
                          ]
                        },
                        {
                          "template": 0,
                          "values": [
                            "b"
                          ]
                        },
                        {
                          "template": 1,
                          "values": [
                            "c"
                          ]
                        }
                      ]
                    }
                  },
                  "provenance": {
                    "inputSha256": "0087aee5b205d2f5247ee37e75b4d5f8cf0510e389a7984416d065178c67b7e3",
                    "outputSha256": "9893c0221a4326c737233d80d598f160bb0cd6fdd3b2c26de15d216866f890cf",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/text-boundary-segment": {
      "post": {
        "operationId": "mpp_text_boundary_segment",
        "summary": "Literal-boundary UTF-8 windows",
        "description": "Create source-preserving UTF-8-byte-bounded text windows with literal double-LF, LF and ASCII-space cut priority, scalar-safe overlap, exact UTF-16/UTF-8 spans and an aggregate duplication budget.",
        "tags": [
          "text"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-boundary-segment.md"
        },
        "x-agent-discovery": {
          "intents": [
            "split text into byte bounded windows",
            "segment document at literal line boundaries",
            "create chunks with exact source spans and overlap budget"
          ],
          "whenToUse": [
            "Creating scalar-safe UTF-8 payload windows from supplied Unicode text",
            "Favoring literal double-LF, LF and ASCII-space boundaries with exact core reconstruction",
            "Bounding aggregate source-byte duplication independently of per-chunk overlap"
          ],
          "whenNotToUse": [
            "Model tokenizer limits, token costs, embedding or semantic retrieval",
            "Sentence, grapheme, word, CommonMark or Unicode line segmentation",
            "Source authenticity, linguistic understanding, normalization or privacy redaction",
            "Fetching sources, writing files, model calls, target execution or changing external state"
          ],
          "capabilities": [
            "Half-open absolute UTF-16 and UTF-8 source/core spans",
            "Nonoverlapping advancing cores with longest scalar-safe preceding-source suffix",
            "Literal boundary priority in the final half of each reserved core byte window",
            "Atomic chunk, returned-text, serialized-output and duplication admission",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "text-chunk",
            "document-chunk-audit",
            "context-budget-pack"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "literal-boundary-utf8-windows-v1",
            "textUtf8Bytes": 60000,
            "textUtf16Units": 60000,
            "maxChunkBytes": 8192,
            "minChunkBytes": 8,
            "overlapBytes": 2048,
            "minimumCoreCapacity": 4,
            "maxDuplicatedBytes": 60000,
            "chunks": 512,
            "returnedTextUtf8Bytes": 120000,
            "boundarySearchProbes": 20000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "TEXT_CAPACITY",
            "TEXT_BYTES_LIMIT",
            "TEXT_CHUNK_LIMIT",
            "TEXT_DUPLICATION_LIMIT",
            "TEXT_RETURNED_BYTES_LIMIT",
            "TEXT_WORK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "maxLength": 60000
                  },
                  "maxChunkBytes": {
                    "type": "integer",
                    "minimum": 8,
                    "maximum": 8192
                  },
                  "overlapBytes": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 2048
                  },
                  "maxDuplicatedBytes": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 60000
                  }
                },
                "required": [
                  "text",
                  "maxChunkBytes",
                  "overlapBytes",
                  "maxDuplicatedBytes"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "A😀 B C",
                "maxChunkBytes": 8,
                "overlapBytes": 2,
                "maxDuplicatedBytes": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-boundary-segment",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "literal-boundary-utf8-windows-v1"
                        },
                        "sourceBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 60000
                        },
                        "returnedTextBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 120000
                        },
                        "duplicatedBytes": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 60000
                        },
                        "chunks": {
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "start": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "end": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "startByte": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "endByte": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "coreStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "coreEnd": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "coreStartByte": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "coreEndByte": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 60000
                              },
                              "text": {
                                "type": "string",
                                "maxLength": 8192
                              },
                              "utf8Bytes": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 8192
                              },
                              "overlapBytes": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 2048
                              },
                              "boundary": {
                                "type": "string",
                                "enum": [
                                  "double-lf",
                                  "lf",
                                  "ascii-space",
                                  "scalar-limit",
                                  "end"
                                ]
                              }
                            },
                            "required": [
                              "start",
                              "end",
                              "startByte",
                              "endByte",
                              "coreStart",
                              "coreEnd",
                              "coreStartByte",
                              "coreEndByte",
                              "text",
                              "utf8Bytes",
                              "overlapBytes",
                              "boundary"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "sourceBytes",
                        "returnedTextBytes",
                        "duplicatedBytes",
                        "chunks"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-boundary-segment",
                  "version": "0.29.0",
                  "result": {
                    "profile": "literal-boundary-utf8-windows-v1",
                    "sourceBytes": 9,
                    "returnedTextBytes": 10,
                    "duplicatedBytes": 1,
                    "chunks": [
                      {
                        "start": 0,
                        "end": 4,
                        "startByte": 0,
                        "endByte": 6,
                        "coreStart": 0,
                        "coreEnd": 4,
                        "coreStartByte": 0,
                        "coreEndByte": 6,
                        "text": "A😀 ",
                        "utf8Bytes": 6,
                        "overlapBytes": 0,
                        "boundary": "ascii-space"
                      },
                      {
                        "start": 3,
                        "end": 7,
                        "startByte": 5,
                        "endByte": 9,
                        "coreStart": 4,
                        "coreEnd": 7,
                        "coreStartByte": 6,
                        "coreEndByte": 9,
                        "text": " B C",
                        "utf8Bytes": 4,
                        "overlapBytes": 1,
                        "boundary": "end"
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "96f0ba6f9e9528c0885e699141905fb70393489c27189f4aecbc5c5ec38c1602",
                    "outputSha256": "6f7758dd5b440e564c1865a1407a6a63ed19a29762fb88f4f85adb4c4f1d82f1",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.004",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/rectangle-set-compose": {
      "post": {
        "operationId": "mpp_rectangle_set_compose",
        "summary": "Exact integer rectangle set algebra",
        "description": "Compose union, intersection, A-minus-B difference or XOR of declared axis-aligned half-open integer rectangles into deterministic x-first disjoint rectangles, exact integer area and bounds.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/rectangle-set-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "union intersect subtract xor rectangular regions",
            "subtract declared exclusions from page tile regions",
            "create canonical disjoint rectangles and exact area"
          ],
          "whenToUse": [
            "Exact set algebra over caller-supplied Cartesian integer regions",
            "Generating disjoint drawing or selection data from axis-aligned half-open rectangles",
            "Computing exact coordinate-squared area beyond JavaScript safe integers"
          ],
          "whenNotToUse": [
            "Rotated shapes, arbitrary polygons, geographic or geodesic area, CRS or units conversion",
            "Image modification, masking, redaction or identifying actual objects",
            "Click safety, collision physics, optimal packing or minimum-rectangle decomposition",
            "Fetching sources, writing files, model calls, target execution or changing external state"
          ],
          "capabilities": [
            "Exact canonical decimal-string coordinates and BigInt arithmetic",
            "Operand unions ignore input ordering and duplicate coverage",
            "X-first interval sweep merges touching selected y intervals and identical intervals across consecutive x slabs",
            "Canonical disjoint output sorted numerically with half-open bounds and exact area",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "interval-analyze"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "integer-half-open-rectangle-sets-v1",
            "inputRectangles": 32,
            "absoluteCoordinate": "1000000000000",
            "xEndpoints": 64,
            "yEndpoints": 64,
            "elementaryCells": 3969,
            "resultRectangles": 1024,
            "outputCoordinateStrings": 4096,
            "sweepWork": 100000
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "RECTANGLE_COUNT_LIMIT",
            "RECTANGLE_COORDINATE_RANGE",
            "RECTANGLE_EXTENT",
            "RECTANGLE_WORK_LIMIT",
            "RECTANGLE_OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "operation": {
                    "type": "string",
                    "enum": [
                      "union",
                      "intersection",
                      "difference",
                      "xor"
                    ]
                  },
                  "a": {
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        }
                      ],
                      "items": false,
                      "minItems": 4,
                      "maxItems": 4
                    }
                  },
                  "b": {
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9][0-9]*)$"
                        }
                      ],
                      "items": false,
                      "minItems": 4,
                      "maxItems": 4
                    }
                  }
                },
                "required": [
                  "operation",
                  "a",
                  "b"
                ],
                "additionalProperties": false
              },
              "example": {
                "operation": "difference",
                "a": [
                  [
                    "0",
                    "0",
                    "6",
                    "4"
                  ]
                ],
                "b": [
                  [
                    "2",
                    "1",
                    "4",
                    "3"
                  ]
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "rectangle-set-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "integer-half-open-rectangle-sets-v1"
                        },
                        "operation": {
                          "type": "string",
                          "enum": [
                            "union",
                            "intersection",
                            "difference",
                            "xor"
                          ]
                        },
                        "coordinateModel": {
                          "type": "string",
                          "const": "caller-integer-grid"
                        },
                        "boundary": {
                          "type": "string",
                          "const": "half-open"
                        },
                        "rectangles": {
                          "maxItems": 1024,
                          "type": "array",
                          "items": {
                            "type": "array",
                            "prefixItems": [
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9][0-9]*)$"
                              },
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9][0-9]*)$"
                              },
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9][0-9]*)$"
                              },
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9][0-9]*)$"
                              }
                            ],
                            "items": false,
                            "minItems": 4,
                            "maxItems": 4
                          }
                        },
                        "area": {
                          "type": "string",
                          "maxLength": 25,
                          "pattern": "^(?:0|[1-9][0-9]*)$"
                        },
                        "bounds": {
                          "anyOf": [
                            {
                              "type": "array",
                              "prefixItems": [
                                {
                                  "type": "string",
                                  "maxLength": 14,
                                  "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                },
                                {
                                  "type": "string",
                                  "maxLength": 14,
                                  "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                },
                                {
                                  "type": "string",
                                  "maxLength": 14,
                                  "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                },
                                {
                                  "type": "string",
                                  "maxLength": 14,
                                  "pattern": "^(?:0|-?[1-9][0-9]*)$"
                                }
                              ],
                              "items": false,
                              "minItems": 4,
                              "maxItems": 4
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "profile",
                        "operation",
                        "coordinateModel",
                        "boundary",
                        "rectangles",
                        "area",
                        "bounds"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "rectangle-set-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "integer-half-open-rectangle-sets-v1",
                    "operation": "difference",
                    "coordinateModel": "caller-integer-grid",
                    "boundary": "half-open",
                    "rectangles": [
                      [
                        "0",
                        "0",
                        "2",
                        "4"
                      ],
                      [
                        "2",
                        "0",
                        "4",
                        "1"
                      ],
                      [
                        "2",
                        "3",
                        "4",
                        "4"
                      ],
                      [
                        "4",
                        "0",
                        "6",
                        "4"
                      ]
                    ],
                    "area": "20",
                    "bounds": [
                      "0",
                      "0",
                      "6",
                      "4"
                    ]
                  },
                  "provenance": {
                    "inputSha256": "78c60701985f51c5f58fd98603b34f2205596ce461af7da13a1083c7454b8021",
                    "outputSha256": "069c4ac83e8387a1f235ddd7b78bccbdfbf2592a44e19809a782352db0e4712c",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/records-crosstab-compose": {
      "post": {
        "operationId": "mpp_records_crosstab_compose",
        "summary": "Exact typed record crosstab",
        "description": "Compose first-occurrence typed row/column axes, dense counts, exact decimal-string sums and per-measure missing/null/valid coverage with aligned margins.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-crosstab-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "build typed exact decimal crosstab matrix",
            "pivot records with missing null measure coverage",
            "compose chart ready counts and decimal totals"
          ],
          "whenToUse": [
            "Producing typed crossed categories with exact decimal sums from supplied records",
            "Preserving missing versus null and scalar-type distinctions",
            "Preparing aligned count grids and row/column/grand totals"
          ],
          "whenNotToUse": [
            "Accounting advice, statistical inference or verification of supplied observations",
            "Floating-point measurements, automatic numeric string coercion or implicit chart conversion",
            "Locale ordering, category normalization or inventing absent categories",
            "Fetching sources, changing external state or executing supplied data"
          ],
          "capabilities": [
            "RFC 6901 selection with first-occurrence typed tuples",
            "Exact BigInt scale-18 decimal aggregation with canonical string outputs",
            "Complete per-measure valid, null and missing coverage",
            "Dense-axis and metric-slot admission before matrix allocation",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "records-aggregate",
            "record-profile",
            "decimal-distribution-summarize"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "typed-exact-decimal-crosstab-v1",
            "records": 1000,
            "rowPointers": 2,
            "columnPointers": 2,
            "measures": 4,
            "axisTuples": 128,
            "denseCells": 1024,
            "metricSlotsIncludingMargins": 4096,
            "pointerSteps": 64000,
            "decimalParses": 4000,
            "decimalIntegerDigits": 24,
            "decimalFractionDigits": 18,
            "pointerCharacters": 2048,
            "measureNameCharacters": 128
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "CROSSTAB_MEASURE_NAME",
            "CROSSTAB_DECIMAL",
            "CROSSTAB_AXIS",
            "CROSSTAB_AXIS_LIMIT",
            "CROSSTAB_CELL_LIMIT",
            "CROSSTAB_WORK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "records": {
                    "maxItems": 1000,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {}
                    }
                  },
                  "rowPointers": {
                    "minItems": 1,
                    "maxItems": 2,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 2048,
                      "pattern": "^(?:\\/(?:[^~]|~[01])*)*$"
                    }
                  },
                  "columnPointers": {
                    "minItems": 1,
                    "maxItems": 2,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 2048,
                      "pattern": "^(?:\\/(?:[^~]|~[01])*)*$"
                    }
                  },
                  "measures": {
                    "maxItems": 4,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "pointer": {
                          "type": "string",
                          "maxLength": 2048,
                          "pattern": "^(?:\\/(?:[^~]|~[01])*)*$"
                        }
                      },
                      "required": [
                        "name",
                        "pointer"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "records",
                  "rowPointers",
                  "columnPointers",
                  "measures"
                ],
                "additionalProperties": false
              },
              "example": {
                "records": [
                  {
                    "team": "A",
                    "status": "open",
                    "amount": "0.1"
                  },
                  {
                    "team": "A",
                    "status": "open",
                    "amount": "0.2"
                  },
                  {
                    "team": "A",
                    "status": "closed",
                    "amount": null
                  },
                  {
                    "team": "B",
                    "status": "open"
                  },
                  {
                    "team": "B",
                    "status": "closed",
                    "amount": "-0.3"
                  }
                ],
                "rowPointers": [
                  "/team"
                ],
                "columnPointers": [
                  "/status"
                ],
                "measures": [
                  {
                    "name": "amount",
                    "pointer": "/amount"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-crosstab-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "typed-exact-decimal-crosstab-v1"
                        },
                        "axisOrder": {
                          "type": "string",
                          "const": "first-occurrence"
                        },
                        "rowAxes": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "minItems": 1,
                            "maxItems": 2,
                            "type": "array",
                            "items": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "missing"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "null"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "string"
                                    },
                                    "value": {
                                      "type": "string",
                                      "maxLength": 100000
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "number"
                                    },
                                    "value": {
                                      "type": "number"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "boolean"
                                    },
                                    "value": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            }
                          }
                        },
                        "columnAxes": {
                          "maxItems": 128,
                          "type": "array",
                          "items": {
                            "minItems": 1,
                            "maxItems": 2,
                            "type": "array",
                            "items": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "missing"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "null"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "string"
                                    },
                                    "value": {
                                      "type": "string",
                                      "maxLength": 100000
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "number"
                                    },
                                    "value": {
                                      "type": "number"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "type": {
                                      "type": "string",
                                      "const": "boolean"
                                    },
                                    "value": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "type",
                                    "value"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            }
                          }
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "cells": {
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "maxItems": 128,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 1000
                                }
                              }
                            },
                            "rowTotals": {
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000
                              }
                            },
                            "columnTotals": {
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000
                              }
                            },
                            "grandTotal": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1000
                            }
                          },
                          "required": [
                            "cells",
                            "rowTotals",
                            "columnTotals",
                            "grandTotal"
                          ],
                          "additionalProperties": false
                        },
                        "measures": {
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              "pointer": {
                                "type": "string",
                                "maxLength": 2048,
                                "pattern": "^(?:\\/(?:[^~]|~[01])*)*$"
                              },
                              "sums": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "maxItems": 128,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "maxLength": 47,
                                        "pattern": "^(?:0|-?[1-9]\\d{0,26}|-?(?:0|[1-9]\\d{0,26})\\.\\d{0,17}[1-9])$"
                                      }
                                    }
                                  },
                                  "rowTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "maxLength": 47,
                                      "pattern": "^(?:0|-?[1-9]\\d{0,26}|-?(?:0|[1-9]\\d{0,26})\\.\\d{0,17}[1-9])$"
                                    }
                                  },
                                  "columnTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "maxLength": 47,
                                      "pattern": "^(?:0|-?[1-9]\\d{0,26}|-?(?:0|[1-9]\\d{0,26})\\.\\d{0,17}[1-9])$"
                                    }
                                  },
                                  "grandTotal": {
                                    "type": "string",
                                    "maxLength": 47,
                                    "pattern": "^(?:0|-?[1-9]\\d{0,26}|-?(?:0|[1-9]\\d{0,26})\\.\\d{0,17}[1-9])$"
                                  }
                                },
                                "required": [
                                  "cells",
                                  "rowTotals",
                                  "columnTotals",
                                  "grandTotal"
                                ],
                                "additionalProperties": false
                              },
                              "validCounts": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "maxItems": 128,
                                      "type": "array",
                                      "items": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 1000
                                      }
                                    }
                                  },
                                  "rowTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "columnTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "grandTotal": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000
                                  }
                                },
                                "required": [
                                  "cells",
                                  "rowTotals",
                                  "columnTotals",
                                  "grandTotal"
                                ],
                                "additionalProperties": false
                              },
                              "nullCounts": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "maxItems": 128,
                                      "type": "array",
                                      "items": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 1000
                                      }
                                    }
                                  },
                                  "rowTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "columnTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "grandTotal": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000
                                  }
                                },
                                "required": [
                                  "cells",
                                  "rowTotals",
                                  "columnTotals",
                                  "grandTotal"
                                ],
                                "additionalProperties": false
                              },
                              "missingCounts": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "maxItems": 128,
                                      "type": "array",
                                      "items": {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 1000
                                      }
                                    }
                                  },
                                  "rowTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "columnTotals": {
                                    "maxItems": 128,
                                    "type": "array",
                                    "items": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 1000
                                    }
                                  },
                                  "grandTotal": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 1000
                                  }
                                },
                                "required": [
                                  "cells",
                                  "rowTotals",
                                  "columnTotals",
                                  "grandTotal"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "name",
                              "pointer",
                              "sums",
                              "validCounts",
                              "nullCounts",
                              "missingCounts"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "axisOrder",
                        "rowAxes",
                        "columnAxes",
                        "counts",
                        "measures"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-crosstab-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "typed-exact-decimal-crosstab-v1",
                    "axisOrder": "first-occurrence",
                    "rowAxes": [
                      [
                        {
                          "type": "string",
                          "value": "A"
                        }
                      ],
                      [
                        {
                          "type": "string",
                          "value": "B"
                        }
                      ]
                    ],
                    "columnAxes": [
                      [
                        {
                          "type": "string",
                          "value": "open"
                        }
                      ],
                      [
                        {
                          "type": "string",
                          "value": "closed"
                        }
                      ]
                    ],
                    "counts": {
                      "cells": [
                        [
                          2,
                          1
                        ],
                        [
                          1,
                          1
                        ]
                      ],
                      "rowTotals": [
                        3,
                        2
                      ],
                      "columnTotals": [
                        3,
                        2
                      ],
                      "grandTotal": 5
                    },
                    "measures": [
                      {
                        "name": "amount",
                        "pointer": "/amount",
                        "sums": {
                          "cells": [
                            [
                              "0.3",
                              "0"
                            ],
                            [
                              "0",
                              "-0.3"
                            ]
                          ],
                          "rowTotals": [
                            "0.3",
                            "-0.3"
                          ],
                          "columnTotals": [
                            "0.3",
                            "-0.3"
                          ],
                          "grandTotal": "0"
                        },
                        "validCounts": {
                          "cells": [
                            [
                              2,
                              0
                            ],
                            [
                              0,
                              1
                            ]
                          ],
                          "rowTotals": [
                            2,
                            1
                          ],
                          "columnTotals": [
                            2,
                            1
                          ],
                          "grandTotal": 3
                        },
                        "nullCounts": {
                          "cells": [
                            [
                              0,
                              1
                            ],
                            [
                              0,
                              0
                            ]
                          ],
                          "rowTotals": [
                            1,
                            0
                          ],
                          "columnTotals": [
                            0,
                            1
                          ],
                          "grandTotal": 1
                        },
                        "missingCounts": {
                          "cells": [
                            [
                              0,
                              0
                            ],
                            [
                              1,
                              0
                            ]
                          ],
                          "rowTotals": [
                            0,
                            1
                          ],
                          "columnTotals": [
                            1,
                            0
                          ],
                          "grandTotal": 1
                        }
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "72b700a118cc9572364a507b93986dd707aadd075e3d697f3242807d7313db75",
                    "outputSha256": "450697aed2f4eb568f1bb009e8db63f0e30a8691f3538227936e23d6345d8b68",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/polyline-rectangle-clip": {
      "post": {
        "operationId": "mpp_polyline_rectangle_clip",
        "summary": "Exact closed rectangle polyline clipping",
        "description": "Clip each directed source segment against a closed integer rectangle and return exact reduced rational parameters and endpoints, preserving point contacts and per-segment provenance.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/polyline-rectangle-clip.md"
        },
        "x-agent-discovery": {
          "intents": [
            "clip polyline to closed rectangle viewport",
            "intersect line segments with exact rational coordinates",
            "retain segment provenance and tangent point intersections"
          ],
          "whenToUse": [
            "Exact viewport clipping on a caller-supplied integer Cartesian grid",
            "Obtaining ordered segment fragments with exact source parameters",
            "Keeping boundary and tangent contacts without rounded coordinates"
          ],
          "whenNotToUse": [
            "Half-open rectangle set operations or polygon clipping",
            "Geodesic distances, CRS conversion, antimeridian handling or physical units",
            "Merging fragments, topology guarantees or direct floating-point renderer output",
            "Fetching sources, changing external state or executing supplied data"
          ],
          "capabilities": [
            "Closed boundaries and exact reduced rational interpolation",
            "Source-order pieces without merging adjacent segments",
            "Inside repeated vertices retain t0=0 and t1=1",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "rectangle-set-compose",
            "polyline-simplify"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "integer-polyline-closed-rectangle-clip-v1",
            "points": 512,
            "pieces": 511,
            "clippingInequalities": 2044,
            "absoluteCoordinate": "1000000000000"
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "POLYLINE_COORDINATE_RANGE",
            "POLYLINE_RECTANGLE_EXTENT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "points": {
                    "minItems": 2,
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                        }
                      ],
                      "items": false,
                      "minItems": 2,
                      "maxItems": 2
                    }
                  },
                  "rectangle": {
                    "type": "array",
                    "prefixItems": [
                      {
                        "type": "string",
                        "maxLength": 14,
                        "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                      },
                      {
                        "type": "string",
                        "maxLength": 14,
                        "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                      },
                      {
                        "type": "string",
                        "maxLength": 14,
                        "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                      },
                      {
                        "type": "string",
                        "maxLength": 14,
                        "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                      }
                    ],
                    "items": false,
                    "minItems": 4,
                    "maxItems": 4
                  }
                },
                "required": [
                  "points",
                  "rectangle"
                ],
                "additionalProperties": false
              },
              "example": {
                "points": [
                  [
                    "-2",
                    "0"
                  ],
                  [
                    "5",
                    "3"
                  ]
                ],
                "rectangle": [
                  "0",
                  "0",
                  "4",
                  "2"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "polyline-rectangle-clip",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "integer-polyline-closed-rectangle-clip-v1"
                        },
                        "coordinateModel": {
                          "type": "string",
                          "const": "caller-integer-grid"
                        },
                        "boundary": {
                          "type": "string",
                          "const": "closed"
                        },
                        "pieces": {
                          "maxItems": 511,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "segmentIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 510
                              },
                              "t0": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 102,
                                    "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 101,
                                    "pattern": "^[1-9]\\d{0,100}$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "t1": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 102,
                                    "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 101,
                                    "pattern": "^[1-9]\\d{0,100}$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "start": {
                                "type": "array",
                                "prefixItems": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 102,
                                        "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 101,
                                        "pattern": "^[1-9]\\d{0,100}$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 102,
                                        "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 101,
                                        "pattern": "^[1-9]\\d{0,100}$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  }
                                ],
                                "items": false,
                                "minItems": 2,
                                "maxItems": 2
                              },
                              "end": {
                                "type": "array",
                                "prefixItems": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 102,
                                        "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 101,
                                        "pattern": "^[1-9]\\d{0,100}$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "maxLength": 102,
                                        "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "maxLength": 101,
                                        "pattern": "^[1-9]\\d{0,100}$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  }
                                ],
                                "items": false,
                                "minItems": 2,
                                "maxItems": 2
                              }
                            },
                            "required": [
                              "segmentIndex",
                              "t0",
                              "t1",
                              "start",
                              "end"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "coordinateModel",
                        "boundary",
                        "pieces"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "polyline-rectangle-clip",
                  "version": "0.29.0",
                  "result": {
                    "profile": "integer-polyline-closed-rectangle-clip-v1",
                    "coordinateModel": "caller-integer-grid",
                    "boundary": "closed",
                    "pieces": [
                      {
                        "segmentIndex": 0,
                        "t0": {
                          "numerator": "2",
                          "denominator": "7"
                        },
                        "t1": {
                          "numerator": "2",
                          "denominator": "3"
                        },
                        "start": [
                          {
                            "numerator": "0",
                            "denominator": "1"
                          },
                          {
                            "numerator": "6",
                            "denominator": "7"
                          }
                        ],
                        "end": [
                          {
                            "numerator": "8",
                            "denominator": "3"
                          },
                          {
                            "numerator": "2",
                            "denominator": "1"
                          }
                        ]
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "1cbe0f994106b3cdfc25cde150ec342300e1513d4566d88ab10f964ba263744f",
                    "outputSha256": "3e112721135d19b01616446d48a0d46335bd8b3d76efcf67cff02782c3431585",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/polyline-simplify": {
      "post": {
        "operationId": "mpp_polyline_simplify",
        "summary": "Exact integer-grid polyline simplification",
        "description": "Simplify a supplied integer polyline with exact point-to-segment Ramer–Douglas–Peucker decisions, original retained indexes and per-final-segment squared vertex-deviation witnesses.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/polyline-simplify.md"
        },
        "x-agent-discovery": {
          "intents": [
            "simplify integer polyline with exact tolerance",
            "reduce original vertices with retained source indexes",
            "certify squared original vertex deviations for a preview trace"
          ],
          "whenToUse": [
            "Reducing original-vertex polylines for previews or vector exports",
            "Requiring exact inclusive tolerance decisions and earliest-index distance ties",
            "Checking original removed vertices against their final enclosing segments"
          ],
          "whenNotToUse": [
            "Minimum-vertex optimization, topology or area preservation",
            "Curve smoothing, map matching or global geometry equivalence",
            "General Hausdorff certificates, geodesic distances or coordinate conversion",
            "Fetching sources, changing external state or executing supplied data"
          ],
          "capabilities": [
            "Iterative exact point-to-segment RDP with endpoint projection clamping",
            "Strictly-greater splitting and earliest-source-index ties",
            "Preserved first/last source indexes including coincident coordinates",
            "Reduced rational maximum squared vertex deviation with earliest witness per segment",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "polyline-rectangle-clip",
            "rectangle-set-compose"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "exact-integer-rdp-polyline-v1",
            "points": 256,
            "absoluteCoordinate": "1000000000000",
            "tolerance": "2000000000000",
            "distanceTests": 35000,
            "worstRdpInteriorTests": 32385,
            "maximumCertificateTests": 254
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "POLYLINE_COORDINATE_RANGE",
            "POLYLINE_TOLERANCE_RANGE",
            "POLYLINE_WORK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "points": {
                    "minItems": 2,
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "type": "array",
                      "prefixItems": [
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                        },
                        {
                          "type": "string",
                          "maxLength": 14,
                          "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                        }
                      ],
                      "items": false,
                      "minItems": 2,
                      "maxItems": 2
                    }
                  },
                  "tolerance": {
                    "type": "string",
                    "maxLength": 13,
                    "pattern": "^(?:0|[1-9]\\d{0,12})$"
                  }
                },
                "required": [
                  "points",
                  "tolerance"
                ],
                "additionalProperties": false
              },
              "example": {
                "points": [
                  [
                    "0",
                    "0"
                  ],
                  [
                    "1",
                    "1"
                  ],
                  [
                    "2",
                    "0"
                  ],
                  [
                    "3",
                    "0"
                  ]
                ],
                "tolerance": "1"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "polyline-simplify",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "exact-integer-rdp-polyline-v1"
                        },
                        "coordinateModel": {
                          "type": "string",
                          "const": "caller-integer-grid"
                        },
                        "indexes": {
                          "minItems": 2,
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 255
                          }
                        },
                        "points": {
                          "minItems": 2,
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "array",
                            "prefixItems": [
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                              },
                              {
                                "type": "string",
                                "maxLength": 14,
                                "pattern": "^(?:0|-?[1-9]\\d{0,12})$"
                              }
                            ],
                            "items": false,
                            "minItems": 2,
                            "maxItems": 2
                          }
                        },
                        "segments": {
                          "minItems": 1,
                          "maxItems": 255,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "startIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 255
                              },
                              "endIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 255
                              },
                              "maxSquaredDeviation": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "maxLength": 102,
                                    "pattern": "^(?:0|-?[1-9]\\d{0,100})$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "maxLength": 101,
                                    "pattern": "^[1-9]\\d{0,100}$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "witnessIndex": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 255
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "startIndex",
                              "endIndex",
                              "maxSquaredDeviation",
                              "witnessIndex"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "coordinateModel",
                        "indexes",
                        "points",
                        "segments"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "polyline-simplify",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-integer-rdp-polyline-v1",
                    "coordinateModel": "caller-integer-grid",
                    "indexes": [
                      0,
                      3
                    ],
                    "points": [
                      [
                        "0",
                        "0"
                      ],
                      [
                        "3",
                        "0"
                      ]
                    ],
                    "segments": [
                      {
                        "startIndex": 0,
                        "endIndex": 3,
                        "maxSquaredDeviation": {
                          "numerator": "1",
                          "denominator": "1"
                        },
                        "witnessIndex": 1
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "e80ee76754de76df6f80c9527775670d590b6da264147352c147e5db9a10f837",
                    "outputSha256": "4204e80b58e4bc7f9d81f32ece7c6a8e16aea1ee8babcce554c1b8d1481457f6",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/keyed-changefeed-materialize": {
      "post": {
        "operationId": "mpp_keyed_changefeed_materialize",
        "summary": "Atomic keyed changefeed snapshot materializer",
        "description": "Fold supplied ordered revision-checked put/delete events into a fresh complete keyed snapshot with tombstones and receipts, or return the first tentative-fold conflict without partial state. Valid conflicts are normal paid results; never reads or writes a database.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/keyed-changefeed-materialize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "materialize revision checked keyed event batch",
            "build next offline snapshot with tombstones",
            "locate first atomic changefeed conflict"
          ],
          "whenToUse": [
            "Preparing a complete next snapshot from caller-supplied records and events",
            "Keeping exact typed tuple identity and explicit revision arithmetic",
            "Inspecting an offline ordered event fold before separately authorized persistence"
          ],
          "whenNotToUse": [
            "Live CDC ingestion, database CAS or transactions, cursor advancement or durable writes",
            "Historical event deduplication, exactly-once execution or authenticated event provenance",
            "Partial record patches, last-writer-wins, tombstone garbage collection or CRDT convergence",
            "Fetching sources, changing external state or executing supplied data"
          ],
          "capabilities": [
            "Atomic complete snapshot or first-conflict diagnostic with no partial receipts",
            "Tombstones and explicit recreation preserve snapshot insertion order",
            "Conflict precedence is revision mismatch, delete not live, then revision exhaustion",
            "Valid materialized and conflict outcomes each incur the proposed per-result price",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "json-patch",
            "idempotency-conflict-check",
            "replay-divergence-check",
            "message-batch-plan"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "explicit-key-revision-fold-v1",
            "snapshotEntries": 512,
            "events": 256,
            "finalKeys": 768,
            "keyComponentsPerTuple": 4,
            "keyComponentVisits": 3072,
            "identifierUtf8Bytes": 128,
            "aggregateKeyTupleUtf8Bytes": 64000,
            "revisionMaximum": "999999999999999999999999",
            "foldSteps": 256
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "MATERIALIZER_DUPLICATE_KEY",
            "MATERIALIZER_EVENT_ID",
            "MATERIALIZER_KEY_LIMIT",
            "STATE_WORK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "snapshot": {
                    "maxItems": 512,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "key": {
                          "minItems": 1,
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 128
                              },
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              }
                            ]
                          }
                        },
                        "revision": {
                          "type": "string",
                          "maxLength": 24,
                          "pattern": "^[1-9]\\d{0,23}$"
                        },
                        "value": {
                          "anyOf": [
                            {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {}
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "key",
                        "revision",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "events": {
                    "maxItems": 256,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "key": {
                              "minItems": 1,
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 128
                                  },
                                  {
                                    "type": "boolean"
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  }
                                ]
                              }
                            },
                            "expectedRevision": {
                              "type": "string",
                              "maxLength": 24,
                              "pattern": "^(?:0|[1-9]\\d{0,23})$"
                            },
                            "op": {
                              "type": "string",
                              "const": "put"
                            },
                            "value": {
                              "type": "object",
                              "propertyNames": {
                                "type": "string"
                              },
                              "additionalProperties": {}
                            }
                          },
                          "required": [
                            "id",
                            "key",
                            "expectedRevision",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 128
                            },
                            "key": {
                              "minItems": 1,
                              "maxItems": 4,
                              "type": "array",
                              "items": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 128
                                  },
                                  {
                                    "type": "boolean"
                                  },
                                  {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  }
                                ]
                              }
                            },
                            "expectedRevision": {
                              "type": "string",
                              "maxLength": 24,
                              "pattern": "^(?:0|[1-9]\\d{0,23})$"
                            },
                            "op": {
                              "type": "string",
                              "const": "delete"
                            }
                          },
                          "required": [
                            "id",
                            "key",
                            "expectedRevision",
                            "op"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "snapshot",
                  "events"
                ],
                "additionalProperties": false
              },
              "example": {
                "snapshot": [
                  {
                    "key": [
                      "a"
                    ],
                    "revision": "1",
                    "value": {
                      "qty": 2
                    }
                  }
                ],
                "events": [
                  {
                    "id": "p1",
                    "key": [
                      "a"
                    ],
                    "expectedRevision": "1",
                    "op": "put",
                    "value": {
                      "qty": 3
                    }
                  },
                  {
                    "id": "d1",
                    "key": [
                      "a"
                    ],
                    "expectedRevision": "2",
                    "op": "delete"
                  },
                  {
                    "id": "p2",
                    "key": [
                      "b"
                    ],
                    "expectedRevision": "0",
                    "op": "put",
                    "value": {
                      "qty": 4
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "keyed-changefeed-materialize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "explicit-key-revision-fold-v1"
                            },
                            "status": {
                              "type": "string",
                              "const": "materialized"
                            },
                            "snapshot": {
                              "maxItems": 768,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "key": {
                                    "minItems": 1,
                                    "maxItems": 4,
                                    "type": "array",
                                    "items": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 128
                                        },
                                        {
                                          "type": "boolean"
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": -9007199254740991,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "revision": {
                                    "type": "string",
                                    "maxLength": 24,
                                    "pattern": "^[1-9]\\d{0,23}$"
                                  },
                                  "value": {
                                    "anyOf": [
                                      {
                                        "type": "object",
                                        "propertyNames": {
                                          "type": "string"
                                        },
                                        "additionalProperties": {}
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "key",
                                  "revision",
                                  "value"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "receipts": {
                              "maxItems": 256,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "eventIndex": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 255
                                  },
                                  "eventId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 128
                                  },
                                  "key": {
                                    "minItems": 1,
                                    "maxItems": 4,
                                    "type": "array",
                                    "items": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 128
                                        },
                                        {
                                          "type": "boolean"
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": -9007199254740991,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "previousRevision": {
                                    "type": "string",
                                    "maxLength": 24,
                                    "pattern": "^(?:0|[1-9]\\d{0,23})$"
                                  },
                                  "revision": {
                                    "type": "string",
                                    "maxLength": 24,
                                    "pattern": "^[1-9]\\d{0,23}$"
                                  },
                                  "op": {
                                    "type": "string",
                                    "enum": [
                                      "put",
                                      "delete"
                                    ]
                                  }
                                },
                                "required": [
                                  "eventIndex",
                                  "eventId",
                                  "key",
                                  "previousRevision",
                                  "revision",
                                  "op"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "conflict": {
                              "type": "null"
                            }
                          },
                          "required": [
                            "profile",
                            "status",
                            "snapshot",
                            "receipts",
                            "conflict"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "explicit-key-revision-fold-v1"
                            },
                            "status": {
                              "type": "string",
                              "const": "conflict"
                            },
                            "snapshot": {
                              "type": "null"
                            },
                            "receipts": {
                              "maxItems": 0,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "eventIndex": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 255
                                  },
                                  "eventId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 128
                                  },
                                  "key": {
                                    "minItems": 1,
                                    "maxItems": 4,
                                    "type": "array",
                                    "items": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 128
                                        },
                                        {
                                          "type": "boolean"
                                        },
                                        {
                                          "type": "integer",
                                          "minimum": -9007199254740991,
                                          "maximum": 9007199254740991
                                        }
                                      ]
                                    }
                                  },
                                  "previousRevision": {
                                    "type": "string",
                                    "maxLength": 24,
                                    "pattern": "^(?:0|[1-9]\\d{0,23})$"
                                  },
                                  "revision": {
                                    "type": "string",
                                    "maxLength": 24,
                                    "pattern": "^[1-9]\\d{0,23}$"
                                  },
                                  "op": {
                                    "type": "string",
                                    "enum": [
                                      "put",
                                      "delete"
                                    ]
                                  }
                                },
                                "required": [
                                  "eventIndex",
                                  "eventId",
                                  "key",
                                  "previousRevision",
                                  "revision",
                                  "op"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "conflict": {
                              "type": "object",
                              "properties": {
                                "eventIndex": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 255
                                },
                                "eventId": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 128
                                },
                                "key": {
                                  "minItems": 1,
                                  "maxItems": 4,
                                  "type": "array",
                                  "items": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 128
                                      },
                                      {
                                        "type": "boolean"
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      }
                                    ]
                                  }
                                },
                                "code": {
                                  "type": "string",
                                  "enum": [
                                    "REVISION_MISMATCH",
                                    "DELETE_NOT_LIVE",
                                    "REVISION_EXHAUSTED"
                                  ]
                                },
                                "expectedRevision": {
                                  "type": "string",
                                  "maxLength": 24,
                                  "pattern": "^(?:0|[1-9]\\d{0,23})$"
                                },
                                "observedRevision": {
                                  "type": "string",
                                  "maxLength": 24,
                                  "pattern": "^(?:0|[1-9]\\d{0,23})$"
                                },
                                "observedState": {
                                  "type": "string",
                                  "enum": [
                                    "absent",
                                    "live",
                                    "tombstone"
                                  ]
                                },
                                "tentativePrefixLength": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 255
                                },
                                "observationScope": {
                                  "type": "string",
                                  "const": "tentative-input-fold"
                                }
                              },
                              "required": [
                                "eventIndex",
                                "eventId",
                                "key",
                                "code",
                                "expectedRevision",
                                "observedRevision",
                                "observedState",
                                "tentativePrefixLength",
                                "observationScope"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "status",
                            "snapshot",
                            "receipts",
                            "conflict"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "keyed-changefeed-materialize",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-key-revision-fold-v1",
                    "status": "materialized",
                    "snapshot": [
                      {
                        "key": [
                          "a"
                        ],
                        "revision": "3",
                        "value": null
                      },
                      {
                        "key": [
                          "b"
                        ],
                        "revision": "1",
                        "value": {
                          "qty": 4
                        }
                      }
                    ],
                    "receipts": [
                      {
                        "eventIndex": 0,
                        "eventId": "p1",
                        "key": [
                          "a"
                        ],
                        "previousRevision": "1",
                        "revision": "2",
                        "op": "put"
                      },
                      {
                        "eventIndex": 1,
                        "eventId": "d1",
                        "key": [
                          "a"
                        ],
                        "previousRevision": "2",
                        "revision": "3",
                        "op": "delete"
                      },
                      {
                        "eventIndex": 2,
                        "eventId": "p2",
                        "key": [
                          "b"
                        ],
                        "previousRevision": "0",
                        "revision": "1",
                        "op": "put"
                      }
                    ],
                    "conflict": null
                  },
                  "provenance": {
                    "inputSha256": "0806420b48aaad2e7df90f6c368d04a2f588e308b57e6536133b1b3593c84b21",
                    "outputSha256": "8e3b4cfcf12793cfa950f05dde67e059ad2da1b5ec7be8f17024463b28337204",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/dependency-version-select": {
      "post": {
        "operationId": "mpp_dependency_version_select",
        "summary": "Exact finite dependency version selector",
        "description": "Select the lexicographically highest jointly compatible stable versions in caller-declared package priority from a complete supplied finite catalogue, with first-failure witnesses for every earlier combination. Valid infeasibility is a normal paid result; never contacts a registry or installs packages.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/dependency-version-select.md"
        },
        "x-agent-discovery": {
          "intents": [
            "select compatible finite dependency versions",
            "pin closed supplied release catalogue",
            "prove lexicographic finite version selection or catalogue infeasibility"
          ],
          "whenToUse": [
            "Choosing one supplied version of every package for a bounded offline release fixture",
            "Resolving conditional version requirements, including self-dependencies and cycles",
            "Regenerating and checking every rejected higher-priority combination from explicit evidence"
          ],
          "whenNotToUse": [
            "Registry lookup, download, installation, native npm lockfile generation or unseen releases",
            "Prerelease/build metadata or npm/pnpm/yarn range, peer, optional, workspace, platform or engine semantics",
            "Authenticity, vulnerability or license checks; minimum-change objectives; installation ordering",
            "Fetching sources, changing external state or executing supplied data"
          ],
          "capabilities": [
            "Typed stable version intervals with union arms and conjunctive active constraints",
            "Exact raw Cartesian domain bounded before enumeration, with last package varying fastest",
            "Input package priority and numeric descending candidates define deterministic selection",
            "Original candidate indexes and flattened source pointers make rejection witnesses reproducible",
            "Valid selected and infeasible outcomes each incur the proposed per-result price",
            "Deterministic supplied-input-only inert artifact; no network, clock, randomness or external state change"
          ],
          "related": [
            "semver-evaluate",
            "lockfile-inventory",
            "contract-version-route"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 10000,
            "depth": 20,
            "profile": "closed-set-stable-semver-selection-v1",
            "packages": 16,
            "candidatesPerPackage": 8,
            "candidates": 64,
            "reachableCandidatesUnderJointCaps": 44,
            "constraints": 128,
            "intervalsPerConstraint": 4,
            "intervals": 512,
            "versionComponentMaximum": 1000000000,
            "identifierUtf8Bytes": 128,
            "completeCombinations": 4096,
            "constraintVisits": 524288,
            "membershipTests": 4096,
            "endpointTriples": 1024,
            "packagePositions": 65536
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "VERSION_CATALOGUE_DUPLICATE",
            "VERSION_CANDIDATE_LIMIT",
            "VERSION_CONSTRAINT_LIMIT",
            "VERSION_INTERVAL_LIMIT",
            "VERSION_INTERVAL",
            "VERSION_TARGET",
            "VERSION_SEARCH_LIMIT",
            "STATE_WORK_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "packages": {
                    "minItems": 1,
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "versions": {
                          "minItems": 1,
                          "maxItems": 8,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "version": {
                                "type": "string",
                                "maxLength": 32,
                                "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                              },
                              "requires": {
                                "maxItems": 128,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "package": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 128
                                    },
                                    "anyOf": {
                                      "minItems": 1,
                                      "maxItems": 4,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "minInclusive": {
                                            "anyOf": [
                                              {
                                                "type": "string",
                                                "maxLength": 32,
                                                "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ]
                                          },
                                          "maxExclusive": {
                                            "anyOf": [
                                              {
                                                "type": "string",
                                                "maxLength": 32,
                                                "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                                              },
                                              {
                                                "type": "null"
                                              }
                                            ]
                                          }
                                        },
                                        "required": [
                                          "minInclusive",
                                          "maxExclusive"
                                        ],
                                        "additionalProperties": false
                                      }
                                    }
                                  },
                                  "required": [
                                    "package",
                                    "anyOf"
                                  ],
                                  "additionalProperties": false
                                }
                              }
                            },
                            "required": [
                              "version",
                              "requires"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "versions"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "requirements": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "package": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 128
                        },
                        "anyOf": {
                          "minItems": 1,
                          "maxItems": 4,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "minInclusive": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 32,
                                    "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "maxExclusive": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 32,
                                    "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "minInclusive",
                              "maxExclusive"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "package",
                        "anyOf"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "packages",
                  "requirements"
                ],
                "additionalProperties": false
              },
              "example": {
                "packages": [
                  {
                    "id": "renderer",
                    "versions": [
                      {
                        "version": "2.0.0",
                        "requires": [
                          {
                            "package": "core",
                            "anyOf": [
                              {
                                "minInclusive": "2.0.0",
                                "maxExclusive": "3.0.0"
                              }
                            ]
                          }
                        ]
                      },
                      {
                        "version": "1.5.0",
                        "requires": [
                          {
                            "package": "core",
                            "anyOf": [
                              {
                                "minInclusive": "1.0.0",
                                "maxExclusive": "2.0.0"
                              }
                            ]
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "id": "exporter",
                    "versions": [
                      {
                        "version": "1.0.0",
                        "requires": [
                          {
                            "package": "core",
                            "anyOf": [
                              {
                                "minInclusive": "1.0.0",
                                "maxExclusive": "2.0.0"
                              }
                            ]
                          }
                        ]
                      }
                    ]
                  },
                  {
                    "id": "core",
                    "versions": [
                      {
                        "version": "2.1.0",
                        "requires": []
                      },
                      {
                        "version": "1.9.0",
                        "requires": []
                      }
                    ]
                  }
                ],
                "requirements": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "dependency-version-select",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "closed-set-stable-semver-selection-v1"
                            },
                            "selectionPolicy": {
                              "type": "string",
                              "const": "input-package-priority-highest-stable-version"
                            },
                            "candidateSourceOrders": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 7
                                }
                              }
                            },
                            "constraintSourcePointers": {
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "maxLength": 64,
                                "pattern": "^(?:\\/requirements\\/\\d+|\\/packages\\/\\d+\\/versions\\/\\d+\\/requires\\/\\d+)$"
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "selected"
                            },
                            "selected": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "packageIndex": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 15
                                  },
                                  "packageId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 128
                                  },
                                  "candidateIndex": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 7
                                  },
                                  "version": {
                                    "type": "string",
                                    "maxLength": 32,
                                    "pattern": "^(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)\\.(?:0|[1-9]\\d{0,8}|1000000000)$"
                                  }
                                },
                                "required": [
                                  "packageIndex",
                                  "packageId",
                                  "candidateIndex",
                                  "version"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "proof": {
                              "type": "object",
                              "properties": {
                                "profile": {
                                  "type": "string",
                                  "const": "mixed-radix-first-failure-v1"
                                },
                                "searchSpaceSize": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 4096
                                },
                                "rejectionConstraintIndexes": {
                                  "maxItems": 4096,
                                  "type": "array",
                                  "items": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 127
                                  }
                                },
                                "selectedOrdinal": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 4095
                                }
                              },
                              "required": [
                                "profile",
                                "searchSpaceSize",
                                "rejectionConstraintIndexes",
                                "selectedOrdinal"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "selectionPolicy",
                            "candidateSourceOrders",
                            "constraintSourcePointers",
                            "status",
                            "selected",
                            "proof"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "closed-set-stable-semver-selection-v1"
                            },
                            "selectionPolicy": {
                              "type": "string",
                              "const": "input-package-priority-highest-stable-version"
                            },
                            "candidateSourceOrders": {
                              "minItems": 1,
                              "maxItems": 16,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "maxItems": 8,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 7
                                }
                              }
                            },
                            "constraintSourcePointers": {
                              "maxItems": 128,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "maxLength": 64,
                                "pattern": "^(?:\\/requirements\\/\\d+|\\/packages\\/\\d+\\/versions\\/\\d+\\/requires\\/\\d+)$"
                              }
                            },
                            "status": {
                              "type": "string",
                              "const": "infeasible"
                            },
                            "selected": {
                              "type": "null"
                            },
                            "proof": {
                              "type": "object",
                              "properties": {
                                "profile": {
                                  "type": "string",
                                  "const": "mixed-radix-first-failure-v1"
                                },
                                "searchSpaceSize": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 4096
                                },
                                "rejectionConstraintIndexes": {
                                  "maxItems": 4096,
                                  "type": "array",
                                  "items": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 127
                                  }
                                },
                                "selectedOrdinal": {
                                  "type": "null"
                                }
                              },
                              "required": [
                                "profile",
                                "searchSpaceSize",
                                "rejectionConstraintIndexes",
                                "selectedOrdinal"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "profile",
                            "selectionPolicy",
                            "candidateSourceOrders",
                            "constraintSourcePointers",
                            "status",
                            "selected",
                            "proof"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "dependency-version-select",
                  "version": "0.29.0",
                  "result": {
                    "profile": "closed-set-stable-semver-selection-v1",
                    "selectionPolicy": "input-package-priority-highest-stable-version",
                    "candidateSourceOrders": [
                      [
                        0,
                        1
                      ],
                      [
                        0
                      ],
                      [
                        0,
                        1
                      ]
                    ],
                    "constraintSourcePointers": [
                      "/packages/0/versions/0/requires/0",
                      "/packages/0/versions/1/requires/0",
                      "/packages/1/versions/0/requires/0"
                    ],
                    "status": "selected",
                    "selected": [
                      {
                        "packageIndex": 0,
                        "packageId": "renderer",
                        "candidateIndex": 1,
                        "version": "1.5.0"
                      },
                      {
                        "packageIndex": 1,
                        "packageId": "exporter",
                        "candidateIndex": 0,
                        "version": "1.0.0"
                      },
                      {
                        "packageIndex": 2,
                        "packageId": "core",
                        "candidateIndex": 1,
                        "version": "1.9.0"
                      }
                    ],
                    "proof": {
                      "profile": "mixed-radix-first-failure-v1",
                      "searchSpaceSize": 4,
                      "rejectionConstraintIndexes": [
                        2,
                        0,
                        1
                      ],
                      "selectedOrdinal": 3
                    }
                  },
                  "provenance": {
                    "inputSha256": "1a43376351d4e6394d1bd8a5ba6158ade9566c0f0245f59a982bc40329a54d24",
                    "outputSha256": "8d93e328f273dc0a99e6a07467368db39f5e7fafd216896d368194aea13ff6a6",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.008",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/records-link-candidates": {
      "post": {
        "operationId": "mpp_records_link_candidates",
        "summary": "Exact Record Link Candidates",
        "description": "Produce every admissible cross-table candidate using explicitly normalized Unicode-scalar Levenshtein distances and exact integer weighted costs. Includes all tied best candidates; never selects an identity, asserts duplicates or merges records.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/records-link-candidates.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Find reproducible near-spelling candidates between small supplied part catalogues",
            "Compare asset labels under explicit normalization and edit-distance cutoffs"
          ],
          "whenToUse": [
            "Return a complete bounded candidate queue with exact field-distance evidence"
          ],
          "whenNotToUse": [
            "Identity resolution, true-duplicate assertions, automatic merging, confidence probabilities or semantic similarity",
            "Medical, employment, credit or other high-impact decisions about people",
            "Large-table nearest neighbors, top-k retrieval or transposition distance",
            "Network requests, file changes, external execution, publishing or deployment"
          ],
          "capabilities": [
            "Exact unit-cost scalar Levenshtein over every cross pair and field; no pruning or truncation",
            "Unicode normalization then ASCII lowercase then ASCII whitespace collapse/trim, each explicitly selected",
            "Unicode normalization supplied by the pinned Worker runtime; NFKC can erase meaningful distinctions",
            "Candidate sort: exact UTF-16 left ID, numeric cost, exact UTF-16 right ID; IDs are never normalized",
            "Complete bounded result computed during semantic preflight before payment challenge; recomputed during execution",
            "Supplied-data-only artifact; externalRequests=0"
          ],
          "related": [
            "records-project",
            "records-join",
            "assignment-cost-optimize"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 20,
            "dpCells": 262144,
            "rowsPerSide": 16,
            "fields": 3,
            "valueScalars": 128,
            "idCodeUnits": 80,
            "weight": 100,
            "maxWeightedDistance": 38400,
            "candidates": 256,
            "comparisonUnit": "unicode-scalars",
            "normalizationOrder": "unicodeForm,asciiCase,asciiWhitespace",
            "candidateSet": "complete-for-declared-rules"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "WORK_LIMIT",
            "DUPLICATE_ID",
            "FIELD_WIDTH",
            "VALUE_LENGTH"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "left": {
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "values": {
                          "minItems": 1,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 256
                          }
                        }
                      },
                      "required": [
                        "id",
                        "values"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "right": {
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "values": {
                          "minItems": 1,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 256
                          }
                        }
                      },
                      "required": [
                        "id",
                        "values"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "fields": {
                    "minItems": 1,
                    "maxItems": 3,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80
                        },
                        "weight": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 100
                        },
                        "maxDistance": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 128
                        },
                        "normalization": {
                          "type": "object",
                          "properties": {
                            "unicodeForm": {
                              "type": "string",
                              "enum": [
                                "none",
                                "NFC",
                                "NFKC"
                              ]
                            },
                            "asciiCase": {
                              "type": "string",
                              "enum": [
                                "preserve",
                                "lower"
                              ]
                            },
                            "asciiWhitespace": {
                              "type": "string",
                              "enum": [
                                "preserve",
                                "collapse-trim"
                              ]
                            }
                          },
                          "required": [
                            "unicodeForm",
                            "asciiCase",
                            "asciiWhitespace"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "id",
                        "weight",
                        "maxDistance",
                        "normalization"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "maxWeightedDistance": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 38400
                  }
                },
                "required": [
                  "left",
                  "right",
                  "fields",
                  "maxWeightedDistance"
                ],
                "additionalProperties": false
              },
              "example": {
                "fields": [
                  {
                    "id": "label",
                    "weight": 2,
                    "maxDistance": 2,
                    "normalization": {
                      "unicodeForm": "NFC",
                      "asciiCase": "lower",
                      "asciiWhitespace": "collapse-trim"
                    }
                  },
                  {
                    "id": "family",
                    "weight": 1,
                    "maxDistance": 0,
                    "normalization": {
                      "unicodeForm": "NFC",
                      "asciiCase": "lower",
                      "asciiWhitespace": "collapse-trim"
                    }
                  }
                ],
                "maxWeightedDistance": 4,
                "left": [
                  {
                    "id": "L1",
                    "values": [
                      " Axle  12 ",
                      "CHASSIS"
                    ]
                  },
                  {
                    "id": "L2",
                    "values": [
                      "pump",
                      "fluid"
                    ]
                  }
                ],
                "right": [
                  {
                    "id": "R1",
                    "values": [
                      "axle 12",
                      "chassis"
                    ]
                  },
                  {
                    "id": "R2",
                    "values": [
                      "axel 12",
                      "chassis"
                    ]
                  },
                  {
                    "id": "R3",
                    "values": [
                      "pump",
                      "fluid"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "records-link-candidates",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "explicit-normalized-levenshtein-candidates-v1"
                        },
                        "fields": {
                          "minItems": 1,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "weight": {
                                "type": "integer",
                                "minimum": 1,
                                "maximum": 100
                              },
                              "maxDistance": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 128
                              },
                              "normalization": {
                                "type": "object",
                                "properties": {
                                  "unicodeForm": {
                                    "type": "string",
                                    "enum": [
                                      "none",
                                      "NFC",
                                      "NFKC"
                                    ]
                                  },
                                  "asciiCase": {
                                    "type": "string",
                                    "enum": [
                                      "preserve",
                                      "lower"
                                    ]
                                  },
                                  "asciiWhitespace": {
                                    "type": "string",
                                    "enum": [
                                      "preserve",
                                      "collapse-trim"
                                    ]
                                  }
                                },
                                "required": [
                                  "unicodeForm",
                                  "asciiCase",
                                  "asciiWhitespace"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "id",
                              "weight",
                              "maxDistance",
                              "normalization"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "maxWeightedDistance": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 38400
                        },
                        "normalizedLeft": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "values": {
                                "minItems": 1,
                                "maxItems": 3,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "maxLength": 256
                                }
                              }
                            },
                            "required": [
                              "id",
                              "values"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "normalizedRight": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "values": {
                                "minItems": 1,
                                "maxItems": 3,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "maxLength": 256
                                }
                              }
                            },
                            "required": [
                              "id",
                              "values"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "candidates": {
                          "maxItems": 256,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "leftId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "rightId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "fieldDistances": {
                                "minItems": 1,
                                "maxItems": 3,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "fieldId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 80
                                    },
                                    "distance": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 128
                                    },
                                    "weightedDistance": {
                                      "type": "integer",
                                      "minimum": 0,
                                      "maximum": 12800
                                    }
                                  },
                                  "required": [
                                    "fieldId",
                                    "distance",
                                    "weightedDistance"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "cost": {
                                "type": "string",
                                "pattern": "^(?:0|[1-9][0-9]*)$"
                              }
                            },
                            "required": [
                              "leftId",
                              "rightId",
                              "fieldDistances",
                              "cost"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "perLeft": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "leftId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 80
                              },
                              "candidateCount": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 16
                              },
                              "minimumCost": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "bestRightIds": {
                                "maxItems": 16,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 80
                                }
                              }
                            },
                            "required": [
                              "leftId",
                              "candidateCount",
                              "minimumCost",
                              "bestRightIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "noCandidateLeftIds": {
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 80
                          }
                        },
                        "pairComparisonCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 256
                        },
                        "fieldComparisonCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 768
                        },
                        "dpCellCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 262144
                        },
                        "candidateSetComplete": {
                          "type": "boolean",
                          "const": true
                        },
                        "identityResolved": {
                          "type": "boolean",
                          "const": false
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "fields",
                        "maxWeightedDistance",
                        "normalizedLeft",
                        "normalizedRight",
                        "candidates",
                        "perLeft",
                        "noCandidateLeftIds",
                        "pairComparisonCount",
                        "fieldComparisonCount",
                        "dpCellCount",
                        "candidateSetComplete",
                        "identityResolved",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "records-link-candidates",
                  "version": "0.29.0",
                  "result": {
                    "profile": "explicit-normalized-levenshtein-candidates-v1",
                    "fields": [
                      {
                        "id": "label",
                        "weight": 2,
                        "maxDistance": 2,
                        "normalization": {
                          "unicodeForm": "NFC",
                          "asciiCase": "lower",
                          "asciiWhitespace": "collapse-trim"
                        }
                      },
                      {
                        "id": "family",
                        "weight": 1,
                        "maxDistance": 0,
                        "normalization": {
                          "unicodeForm": "NFC",
                          "asciiCase": "lower",
                          "asciiWhitespace": "collapse-trim"
                        }
                      }
                    ],
                    "maxWeightedDistance": 4,
                    "normalizedLeft": [
                      {
                        "id": "L1",
                        "values": [
                          "axle 12",
                          "chassis"
                        ]
                      },
                      {
                        "id": "L2",
                        "values": [
                          "pump",
                          "fluid"
                        ]
                      }
                    ],
                    "normalizedRight": [
                      {
                        "id": "R1",
                        "values": [
                          "axle 12",
                          "chassis"
                        ]
                      },
                      {
                        "id": "R2",
                        "values": [
                          "axel 12",
                          "chassis"
                        ]
                      },
                      {
                        "id": "R3",
                        "values": [
                          "pump",
                          "fluid"
                        ]
                      }
                    ],
                    "candidates": [
                      {
                        "leftId": "L1",
                        "rightId": "R1",
                        "fieldDistances": [
                          {
                            "fieldId": "label",
                            "distance": 0,
                            "weightedDistance": 0
                          },
                          {
                            "fieldId": "family",
                            "distance": 0,
                            "weightedDistance": 0
                          }
                        ],
                        "cost": "0"
                      },
                      {
                        "leftId": "L1",
                        "rightId": "R2",
                        "fieldDistances": [
                          {
                            "fieldId": "label",
                            "distance": 2,
                            "weightedDistance": 4
                          },
                          {
                            "fieldId": "family",
                            "distance": 0,
                            "weightedDistance": 0
                          }
                        ],
                        "cost": "4"
                      },
                      {
                        "leftId": "L2",
                        "rightId": "R3",
                        "fieldDistances": [
                          {
                            "fieldId": "label",
                            "distance": 0,
                            "weightedDistance": 0
                          },
                          {
                            "fieldId": "family",
                            "distance": 0,
                            "weightedDistance": 0
                          }
                        ],
                        "cost": "0"
                      }
                    ],
                    "perLeft": [
                      {
                        "leftId": "L1",
                        "candidateCount": 2,
                        "minimumCost": "0",
                        "bestRightIds": [
                          "R1"
                        ]
                      },
                      {
                        "leftId": "L2",
                        "candidateCount": 1,
                        "minimumCost": "0",
                        "bestRightIds": [
                          "R3"
                        ]
                      }
                    ],
                    "noCandidateLeftIds": [],
                    "pairComparisonCount": 6,
                    "fieldComparisonCount": 12,
                    "dpCellCount": 581,
                    "candidateSetComplete": true,
                    "identityResolved": false,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "588279a822903512cb726f70c274fe5639f800e1c38cb18a1f1212977f108aa1",
                    "outputSha256": "066667d2abaa77c4727ecf26453c0db3274d95e1008d452b7555be3af7f429eb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/text-edit-align": {
      "post": {
        "operationId": "mpp_text_edit_align",
        "summary": "Exact Scalar Text Edit Alignment",
        "description": "Generate a minimum unit-edit alignment of two supplied short texts with deterministic ties, scalar/UTF-16/UTF-8 spans, exact digests and a fully guarded text-edits-apply request. Preserves every supplied scalar and newline without normalization.",
        "tags": [
          "data-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/text-edit-align.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Generate guarded text edits from two short exact text versions",
            "Align scalar changes with Unicode byte and code-unit offset evidence"
          ],
          "whenToUse": [
            "Produce a complete reproducible minimum unit-edit script and consumer-ready guarded edit request"
          ],
          "whenNotToUse": [
            "Line, token, grapheme or semantic alignment; fuzzy anchoring or transposition distance",
            "Long documents or more than 200 separated changed blocks",
            "Network requests, file changes, external execution, publishing or deployment"
          ],
          "capabilities": [
            "Suffix DP with optimal step precedence equal, substitute, delete, insert",
            "Coalesce adjacent equal steps only; every non-equal step stays scalar-granular",
            "Guarded edits group maximal contiguous non-equal blocks without crossing equal text",
            "Actual consumer input schema and complete generated-input semantic checks before challenge; consumer purchase/execution remains separate",
            "Exact UTF-8 SHA-256 provenance; no normalization, trimming or newline conversion",
            "Complete bounded result computed during semantic preflight before payment challenge; recomputed during execution",
            "Supplied-data-only artifact; externalRequests=0"
          ],
          "related": [
            "text-edits-apply",
            "text-offset-map",
            "lines-diff"
          ],
          "limits": {
            "inputBytes": 100000,
            "outputBytes": 300000,
            "jsonNodes": 12000,
            "depth": 20,
            "dpCells": 262144,
            "textScalars": 512,
            "atomicSteps": 1024,
            "editBlocks": 200,
            "editOffsetUnit": "utf16-code-units",
            "alignmentUnit": "unicode-scalars",
            "tieOrder": "equal,substitute,delete,insert"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "WORK_LIMIT",
            "TEXT_LENGTH",
            "EDIT_BLOCK_LIMIT",
            "CONSUMER_INPUT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "before": {
                    "type": "string",
                    "maxLength": 1024
                  },
                  "after": {
                    "type": "string",
                    "maxLength": 1024
                  }
                },
                "required": [
                  "before",
                  "after"
                ],
                "additionalProperties": false
              },
              "example": {
                "before": "A😀cat\n",
                "after": "A😀cut!\n"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "text-edit-align",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "scalar-unit-edit-alignment-v1"
                        },
                        "tieOrder": {
                          "type": "array",
                          "prefixItems": [
                            {
                              "type": "string",
                              "const": "equal"
                            },
                            {
                              "type": "string",
                              "const": "substitute"
                            },
                            {
                              "type": "string",
                              "const": "delete"
                            },
                            {
                              "type": "string",
                              "const": "insert"
                            }
                          ],
                          "items": false,
                          "minItems": 4,
                          "maxItems": 4
                        },
                        "distance": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 512
                        },
                        "counts": {
                          "type": "object",
                          "properties": {
                            "insertions": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 512
                            },
                            "deletions": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 512
                            },
                            "substitutions": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 512
                            }
                          },
                          "required": [
                            "insertions",
                            "deletions",
                            "substitutions"
                          ],
                          "additionalProperties": false
                        },
                        "before": {
                          "type": "object",
                          "properties": {
                            "scalar": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 512
                            },
                            "utf16": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1024
                            },
                            "utf8": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 2048
                            }
                          },
                          "required": [
                            "scalar",
                            "utf16",
                            "utf8"
                          ],
                          "additionalProperties": false
                        },
                        "after": {
                          "type": "object",
                          "properties": {
                            "scalar": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 512
                            },
                            "utf16": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 1024
                            },
                            "utf8": {
                              "type": "integer",
                              "minimum": 0,
                              "maximum": 2048
                            }
                          },
                          "required": [
                            "scalar",
                            "utf16",
                            "utf8"
                          ],
                          "additionalProperties": false
                        },
                        "beforeSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "afterSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "digestEncoding": {
                          "type": "string",
                          "const": "exact-utf8"
                        },
                        "dpCellCount": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 262144
                        },
                        "operations": {
                          "maxItems": 1024,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "op": {
                                "type": "string",
                                "enum": [
                                  "equal",
                                  "substitute",
                                  "delete",
                                  "insert"
                                ]
                              },
                              "source": {
                                "type": "object",
                                "properties": {
                                  "scalar": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  },
                                  "utf16": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  },
                                  "utf8": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  }
                                },
                                "required": [
                                  "scalar",
                                  "utf16",
                                  "utf8"
                                ],
                                "additionalProperties": false
                              },
                              "target": {
                                "type": "object",
                                "properties": {
                                  "scalar": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  },
                                  "utf16": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  },
                                  "utf8": {
                                    "type": "array",
                                    "prefixItems": [
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "integer",
                                        "minimum": 0,
                                        "maximum": 9007199254740991
                                      }
                                    ],
                                    "items": false,
                                    "minItems": 2,
                                    "maxItems": 2
                                  }
                                },
                                "required": [
                                  "scalar",
                                  "utf16",
                                  "utf8"
                                ],
                                "additionalProperties": false
                              },
                              "sourceText": {
                                "type": "string"
                              },
                              "targetText": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "op",
                              "source",
                              "target",
                              "sourceText",
                              "targetText"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "applyRequest": {
                          "type": "object",
                          "properties": {
                            "text": {
                              "type": "string"
                            },
                            "expectedSha256": {
                              "type": "string",
                              "pattern": "^[0-9a-f]{64}$"
                            },
                            "edits": {
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 80
                                  },
                                  "start": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "end": {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  "expected": {
                                    "type": "string"
                                  },
                                  "replacement": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "start",
                                  "end",
                                  "expected",
                                  "replacement"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "text",
                            "expectedSha256",
                            "edits"
                          ],
                          "additionalProperties": false
                        },
                        "consumerValidated": {
                          "type": "boolean",
                          "const": true
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        }
                      },
                      "required": [
                        "profile",
                        "tieOrder",
                        "distance",
                        "counts",
                        "before",
                        "after",
                        "beforeSha256",
                        "afterSha256",
                        "digestEncoding",
                        "dpCellCount",
                        "operations",
                        "applyRequest",
                        "consumerValidated",
                        "externalRequests"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "text-edit-align",
                  "version": "0.29.0",
                  "result": {
                    "profile": "scalar-unit-edit-alignment-v1",
                    "tieOrder": [
                      "equal",
                      "substitute",
                      "delete",
                      "insert"
                    ],
                    "distance": 2,
                    "counts": {
                      "insertions": 1,
                      "deletions": 0,
                      "substitutions": 1
                    },
                    "before": {
                      "scalar": 6,
                      "utf16": 7,
                      "utf8": 9
                    },
                    "after": {
                      "scalar": 7,
                      "utf16": 8,
                      "utf8": 10
                    },
                    "beforeSha256": "c413f26d179faf31f2918a1c080a2004c7ee7f9bee8f1a2138342a9d56e078b6",
                    "afterSha256": "adcffe9889029b9ee89f1d701983df061893f2e639ff91db6ffcad296cff2911",
                    "digestEncoding": "exact-utf8",
                    "dpCellCount": 56,
                    "operations": [
                      {
                        "op": "equal",
                        "source": {
                          "scalar": [
                            0,
                            3
                          ],
                          "utf16": [
                            0,
                            4
                          ],
                          "utf8": [
                            0,
                            6
                          ]
                        },
                        "target": {
                          "scalar": [
                            0,
                            3
                          ],
                          "utf16": [
                            0,
                            4
                          ],
                          "utf8": [
                            0,
                            6
                          ]
                        },
                        "sourceText": "A😀c",
                        "targetText": "A😀c"
                      },
                      {
                        "op": "substitute",
                        "source": {
                          "scalar": [
                            3,
                            4
                          ],
                          "utf16": [
                            4,
                            5
                          ],
                          "utf8": [
                            6,
                            7
                          ]
                        },
                        "target": {
                          "scalar": [
                            3,
                            4
                          ],
                          "utf16": [
                            4,
                            5
                          ],
                          "utf8": [
                            6,
                            7
                          ]
                        },
                        "sourceText": "a",
                        "targetText": "u"
                      },
                      {
                        "op": "equal",
                        "source": {
                          "scalar": [
                            4,
                            5
                          ],
                          "utf16": [
                            5,
                            6
                          ],
                          "utf8": [
                            7,
                            8
                          ]
                        },
                        "target": {
                          "scalar": [
                            4,
                            5
                          ],
                          "utf16": [
                            5,
                            6
                          ],
                          "utf8": [
                            7,
                            8
                          ]
                        },
                        "sourceText": "t",
                        "targetText": "t"
                      },
                      {
                        "op": "insert",
                        "source": {
                          "scalar": [
                            5,
                            5
                          ],
                          "utf16": [
                            6,
                            6
                          ],
                          "utf8": [
                            8,
                            8
                          ]
                        },
                        "target": {
                          "scalar": [
                            5,
                            6
                          ],
                          "utf16": [
                            6,
                            7
                          ],
                          "utf8": [
                            8,
                            9
                          ]
                        },
                        "sourceText": "",
                        "targetText": "!"
                      },
                      {
                        "op": "equal",
                        "source": {
                          "scalar": [
                            5,
                            6
                          ],
                          "utf16": [
                            6,
                            7
                          ],
                          "utf8": [
                            8,
                            9
                          ]
                        },
                        "target": {
                          "scalar": [
                            6,
                            7
                          ],
                          "utf16": [
                            7,
                            8
                          ],
                          "utf8": [
                            9,
                            10
                          ]
                        },
                        "sourceText": "\n",
                        "targetText": "\n"
                      }
                    ],
                    "applyRequest": {
                      "text": "A😀cat\n",
                      "expectedSha256": "c413f26d179faf31f2918a1c080a2004c7ee7f9bee8f1a2138342a9d56e078b6",
                      "edits": [
                        {
                          "id": "e000",
                          "start": 4,
                          "end": 5,
                          "expected": "a",
                          "replacement": "u"
                        },
                        {
                          "id": "e001",
                          "start": 6,
                          "end": 6,
                          "expected": "",
                          "replacement": "!"
                        }
                      ]
                    },
                    "consumerValidated": true,
                    "externalRequests": 0
                  },
                  "provenance": {
                    "inputSha256": "f90c8be8123103b347d0ea86db5571ec73dfb0a46de190ba7f761b4787aa2cad",
                    "outputSha256": "346e06c8ac2c43944f12e853e875b8d69f68f31225ee4b36876ffc2c2b278d7a",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/json-jcs-canonicalize": {
      "post": {
        "operationId": "mpp_json_jcs_canonicalize",
        "summary": "JCS JSON Source Canonicalizer",
        "description": "Canonicalize strict supplied JSON source with duplicate-name, Unicode and binary64 admission to bounded RFC 8785-compatible UTF-8 text and SHA-256. No signing, authenticity, authorization or lossless decimal guarantee.",
        "tags": [
          "structured"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/json-jcs-canonicalize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "canonicalize strict JSON source to RFC 8785 bytes",
            "detect duplicate JSON names before canonicalization",
            "prepare JCS binary64 artifacts for offline consumers"
          ],
          "whenToUse": [
            "An external consumer explicitly requires the bounded jcs-rfc8785-source-binary64-v1 profile",
            "Source JSON must retain duplicate-member visibility and recursively sorted UTF-16 object keys"
          ],
          "whenNotToUse": [
            "Lossless arbitrary-precision decimal or large-integer semantics; represent such data as strings",
            "Repairing JSON, authorizing actions, signing, authenticating authors or proving content correctness",
            "Secrets or personal data that must not be disclosed; unsalted artifact hashes do not anonymize inputs"
          ],
          "capabilities": [
            "Strict raw-source grammar; escaped duplicate names rejected before ordinary object construction",
            "Rejects negative zero per verified erratum 7920, underflow-to-zero, nonfinite numbers, lone surrogates and Unicode noncharacters",
            "Exact canonical UTF-8 length and SHA-256; arrays and Unicode normalization distinctions preserved",
            "Deterministic supplied-input-only operation without network, clock or randomness"
          ],
          "related": [
            "json-canonicalize",
            "http-signature-base-compose",
            "content-digest"
          ],
          "limits": {
            "inputBytes": 16384,
            "jsonNodes": 1024,
            "depth": 12,
            "sourceBytes": 8192,
            "outputBytes": 200000,
            "canonicalBytes": 8192,
            "sourceNodes": 1024,
            "sourceDepth": 32,
            "collectionEntries": 256,
            "keyBytes": 1024,
            "numberTokenBytes": 128,
            "profile": "jcs-rfc8785-source-binary64-v1"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_JSON_SOURCE",
            "DUPLICATE_MEMBER",
            "INVALID_UNICODE",
            "NUMBER_DOMAIN",
            "NEGATIVE_ZERO",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "source": {
                    "type": "string",
                    "maxLength": 8192
                  },
                  "numberMode": {
                    "type": "string",
                    "const": "binary64"
                  }
                },
                "required": [
                  "source",
                  "numberMode"
                ],
                "additionalProperties": false
              },
              "example": {
                "source": "{\"2\":2,\"10\":10,\"a\":0,\"é\":\"e\\u0301\"}",
                "numberMode": "binary64"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "json-jcs-canonicalize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "jcs-rfc8785-source-binary64-v1"
                        },
                        "canonical": {
                          "type": "string",
                          "maxLength": 8192
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 8192
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$(?![\\s\\S])"
                        },
                        "numberMode": {
                          "type": "string",
                          "const": "binary64"
                        }
                      },
                      "required": [
                        "profile",
                        "canonical",
                        "byteLength",
                        "sha256",
                        "numberMode"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "json-jcs-canonicalize",
                  "version": "0.29.0",
                  "result": {
                    "profile": "jcs-rfc8785-source-binary64-v1",
                    "canonical": "{\"10\":10,\"2\":2,\"a\":0,\"é\":\"é\"}",
                    "byteLength": 32,
                    "sha256": "fc981f41457715bc2aaca00e3153740b569f2a19593fdd4839734c78d5414af4",
                    "numberMode": "binary64"
                  },
                  "provenance": {
                    "inputSha256": "02411289e3c3a2332abe689ed36f95795c49c60a38aed30d77663bbcf8effff7",
                    "outputSha256": "fa07ed8840b1c50f9e1d9bb50aaf6356db96a4f52c6605a581381f4f97773977",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.005",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/http-signature-base-compose": {
      "post": {
        "operationId": "mpp_http_signature_base_compose",
        "summary": "Compose an HTTP request signature base",
        "description": "Compose inert ASCII RFC 9421 request signature-base and Signature-Input artifacts from ordered, supplied non-secret field examples and explicit context. Does not sign, verify, authorize or send requests.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-signature-base-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compose an HTTP request signature base",
            "extract ordered RFC 9421 request components"
          ],
          "whenToUse": [
            "Build an inert signature-base example from supplied request context and ordered ASCII field lines",
            "Compare raw and binary-wrapped field boundaries before using an external signer"
          ],
          "whenNotToUse": [
            "Signing, verification, keys, credentials, authentication, authorization, payment, or live HTTP requests",
            "Responses, trailers, CONNECT, query-parameter selection, Structured Field parsing, Unicode or obs-text fields",
            "Secret or production request payloads, including secrets in targets, free text or key identifiers"
          ],
          "capabilities": [
            "Ordered field provenance and per-line binary wrapping",
            "Strict bounded schema and complete semantic preflight before execution",
            "Exact ASCII artifacts, byte lengths and SHA-256 artifact hashes"
          ],
          "limits": {
            "inputBytes": 16384,
            "jsonNodes": 1024,
            "depth": 12,
            "outputBytes": 200000,
            "headerLines": 64,
            "headerNameBytes": 64,
            "headerValueBytes": 1024,
            "aggregateHeaderValueBytes": 4096,
            "targetBytes": 1024,
            "authorityBytes": 259,
            "components": 32,
            "parameters": 6,
            "labelBytes": 64,
            "signatureBaseBytes": 8192,
            "signatureInputBytes": 4096
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_UNICODE",
            "INPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "OUTPUT_LIMIT",
            "INVALID_REQUEST_CONTEXT",
            "INVALID_FIELD",
            "FORBIDDEN_FIELD",
            "UNSUPPORTED_COMPONENT",
            "DUPLICATE_COMPONENT",
            "MISSING_COMPONENT",
            "AMBIGUOUS_FIELD",
            "INVALID_PARAMETER"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "request": {
                    "type": "object",
                    "properties": {
                      "method": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 32,
                        "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$(?![\\s\\S])"
                      },
                      "scheme": {
                        "type": "string",
                        "enum": [
                          "http",
                          "https"
                        ]
                      },
                      "authority": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 259,
                        "pattern": "^[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?(?::[1-9][0-9]{0,4})?$(?![\\s\\S])"
                      },
                      "target": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 1024,
                        "pattern": "^\\/(?:[A-Za-z0-9._~!$&'()*+,;=:@/-]|%[0-9A-Fa-f]{2})*(?:\\?(?:[A-Za-z0-9._~!$&'()*+,;=:@/?-]|%[0-9A-Fa-f]{2})*)?$(?![\\s\\S])"
                      },
                      "headers": {
                        "maxItems": 64,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64,
                              "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+$(?![\\s\\S])"
                            },
                            "value": {
                              "type": "string",
                              "maxLength": 1024,
                              "pattern": "^[\\x09\\x20-\\x7e]*$(?![\\s\\S])"
                            }
                          },
                          "required": [
                            "name",
                            "value"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "method",
                      "scheme",
                      "authority",
                      "target",
                      "headers"
                    ],
                    "additionalProperties": false
                  },
                  "label": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64,
                    "pattern": "^[a-z*][a-z0-9_.*-]*$(?![\\s\\S])"
                  },
                  "components": {
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "derived"
                            },
                            "name": {
                              "type": "string",
                              "enum": [
                                "@method",
                                "@scheme",
                                "@authority",
                                "@target-uri",
                                "@path",
                                "@query"
                              ]
                            }
                          },
                          "required": [
                            "type",
                            "name"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "const": "field"
                            },
                            "name": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64,
                              "pattern": "^[!#$%&'*+.^_`|~0-9a-z-]+$(?![\\s\\S])"
                            },
                            "mode": {
                              "type": "string",
                              "enum": [
                                "raw",
                                "binary"
                              ]
                            }
                          },
                          "required": [
                            "type",
                            "name",
                            "mode"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  },
                  "parameters": {
                    "minItems": 1,
                    "maxItems": 6,
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "enum": [
                                "created",
                                "expires"
                              ]
                            },
                            "value": {
                              "type": "string",
                              "maxLength": 15,
                              "pattern": "^(?:0|[1-9][0-9]{0,14})$(?![\\s\\S])"
                            }
                          },
                          "required": [
                            "name",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "enum": [
                                "keyid",
                                "nonce",
                                "tag"
                              ]
                            },
                            "value": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 256,
                              "pattern": "^[\\x20-\\x7e]*$(?![\\s\\S])"
                            }
                          },
                          "required": [
                            "name",
                            "value"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "const": "alg"
                            },
                            "value": {
                              "type": "string",
                              "enum": [
                                "rsa-pss-sha512",
                                "rsa-v1_5-sha256",
                                "hmac-sha256",
                                "ecdsa-p256-sha256",
                                "ecdsa-p384-sha384",
                                "ed25519"
                              ]
                            }
                          },
                          "required": [
                            "name",
                            "value"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    }
                  }
                },
                "required": [
                  "request",
                  "label",
                  "components",
                  "parameters"
                ],
                "additionalProperties": false
              },
              "example": {
                "request": {
                  "method": "POST",
                  "scheme": "https",
                  "authority": "api.example.com",
                  "target": "/v1/items?limit=10",
                  "headers": [
                    {
                      "name": "Content-Type",
                      "value": "application/json"
                    },
                    {
                      "name": "Cache-Control",
                      "value": "max-age=60"
                    },
                    {
                      "name": "cache-control",
                      "value": " no-transform "
                    }
                  ]
                },
                "label": "demo",
                "components": [
                  {
                    "type": "derived",
                    "name": "@method"
                  },
                  {
                    "type": "derived",
                    "name": "@authority"
                  },
                  {
                    "type": "derived",
                    "name": "@path"
                  },
                  {
                    "type": "derived",
                    "name": "@query"
                  },
                  {
                    "type": "field",
                    "name": "content-type",
                    "mode": "raw"
                  },
                  {
                    "type": "field",
                    "name": "cache-control",
                    "mode": "raw"
                  }
                ],
                "parameters": [
                  {
                    "name": "created",
                    "value": "1700000000"
                  },
                  {
                    "name": "keyid",
                    "value": "demo-key"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-signature-base-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-sig-rfc9421-request-ascii-v1"
                        },
                        "signatureBase": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 8192,
                          "pattern": "^[\\x09\\x0a\\x20-\\x7e]*$(?![\\s\\S])"
                        },
                        "byteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 8192
                        },
                        "sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$(?![\\s\\S])"
                        },
                        "signatureInput": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string",
                              "const": "signature-input"
                            },
                            "value": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 4096,
                              "pattern": "^[\\x20-\\x7e]*$(?![\\s\\S])"
                            },
                            "byteLength": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 4096
                            },
                            "sha256": {
                              "type": "string",
                              "pattern": "^[a-f0-9]{64}$(?![\\s\\S])"
                            }
                          },
                          "required": [
                            "name",
                            "value",
                            "byteLength",
                            "sha256"
                          ],
                          "additionalProperties": false
                        },
                        "components": {
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "identifier": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 69,
                                "pattern": "^[\\x20-\\x7e]*$(?![\\s\\S])"
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 8192,
                                "pattern": "^[\\x09\\x20-\\x7e]*$(?![\\s\\S])"
                              },
                              "headerIndexes": {
                                "maxItems": 64,
                                "type": "array",
                                "items": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 63
                                }
                              }
                            },
                            "required": [
                              "identifier",
                              "value",
                              "headerIndexes"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "signatureBase",
                        "byteLength",
                        "sha256",
                        "signatureInput",
                        "components"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-signature-base-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-sig-rfc9421-request-ascii-v1",
                    "signatureBase": "\"@method\": POST\n\"@authority\": api.example.com\n\"@path\": /v1/items\n\"@query\": ?limit=10\n\"content-type\": application/json\n\"cache-control\": max-age=60, no-transform\n\"@signature-params\": (\"@method\" \"@authority\" \"@path\" \"@query\" \"content-type\" \"cache-control\");created=1700000000;keyid=\"demo-key\"",
                    "byteLength": 289,
                    "sha256": "65400d9ddc9e40a9d916cf84f6fcb158dd7a0eda5ac3aab66d0edfd12b01eb0d",
                    "signatureInput": {
                      "name": "signature-input",
                      "value": "demo=(\"@method\" \"@authority\" \"@path\" \"@query\" \"content-type\" \"cache-control\");created=1700000000;keyid=\"demo-key\"",
                      "byteLength": 113,
                      "sha256": "5f6fb3f5e0453d1599d8ae03a24e9e6052ff9180b2e0fd4533afe79e35ed5cbd"
                    },
                    "components": [
                      {
                        "identifier": "\"@method\"",
                        "value": "POST",
                        "headerIndexes": []
                      },
                      {
                        "identifier": "\"@authority\"",
                        "value": "api.example.com",
                        "headerIndexes": []
                      },
                      {
                        "identifier": "\"@path\"",
                        "value": "/v1/items",
                        "headerIndexes": []
                      },
                      {
                        "identifier": "\"@query\"",
                        "value": "?limit=10",
                        "headerIndexes": []
                      },
                      {
                        "identifier": "\"content-type\"",
                        "value": "application/json",
                        "headerIndexes": [
                          0
                        ]
                      },
                      {
                        "identifier": "\"cache-control\"",
                        "value": "max-age=60, no-transform",
                        "headerIndexes": [
                          1,
                          2
                        ]
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "4c566ce40d6d3390f029304d7fea2ae98b0f787afa766c0168a44f5132a73e57",
                    "outputSha256": "fb2b84b135aa6b57b8b49279f1c9ce1b410a052b89201d78f4322d82c88b3df3",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/http-byte-ranges-resolve": {
      "post": {
        "operationId": "mpp_http_byte_ranges_resolve",
        "summary": "Resolve exact HTTP byte ranges",
        "description": "Resolve a strict supplied HTTP bytes Range field against an exact decimal representation length, retaining requested order, duplicates, unsatisfied members and half-open spans. No coalescing, server preconditions, fetching or response transmission.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-byte-ranges-resolve.md"
        },
        "x-agent-discovery": {
          "intents": [
            "resolve HTTP byte range suffix offsets",
            "exact Range header interval plan",
            "interpret byte ranges for supplied representation length"
          ],
          "whenToUse": [
            "Inspect bounded Range syntax and exact byte spans even when only a large representation length is available"
          ],
          "whenNotToUse": [
            "No remote fetching, request transmission, filesystem access, caching, content decoding or authenticity verification",
            "No server policy, method, conditional request or If-Range enforcement; callers must check applicability separately",
            "Not a full HTTP parser: unsupported units, empty list members, inner whitespace and numbers over 20 digits are rejected by this bounded profile"
          ],
          "capabilities": [
            "Exact decimal integer arithmetic up to 20 digits per coordinate",
            "Closed, open-ended and suffix ranges with input-order provenance",
            "Nonzero empty-representation suffixes remain satisfiable; selected-byte totals count overlaps and duplicates repeatedly"
          ],
          "related": [
            "http-byte-ranges-compose",
            "http-etag-evaluate",
            "interval-analyze"
          ],
          "limits": {
            "inputBytes": 16384,
            "outputBytes": 24576,
            "jsonNodes": 128,
            "depth": 4,
            "rangeBytes": 2048,
            "ranges": 16,
            "integerDigits": 20,
            "profile": "http-byte-ranges-exact-v1"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_UNICODE",
            "INVALID_RANGE",
            "INPUT_LIMIT",
            "INTEGER_LIMIT",
            "RANGE_LIMIT",
            "COMPLEXITY_LIMIT",
            "OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "range": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2048,
                    "pattern": "^[\\x09\\x20-\\x7e]+$(?![\\s\\S])"
                  },
                  "representationLength": {
                    "type": "string",
                    "maxLength": 20,
                    "pattern": "^(?:0|[1-9][0-9]{0,19})$(?![\\s\\S])"
                  }
                },
                "required": [
                  "range",
                  "representationLength"
                ],
                "additionalProperties": false
              },
              "example": {
                "range": "bytes=0-1,8-,-0,99-100",
                "representationLength": "10"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-byte-ranges-resolve",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-byte-ranges-exact-v1"
                        },
                        "representationLength": {
                          "type": "string",
                          "maxLength": 20,
                          "pattern": "^(?:0|[1-9][0-9]{0,19})$(?![\\s\\S])"
                        },
                        "normalizedRange": {
                          "type": "string",
                          "maxLength": 2048
                        },
                        "satisfiable": {
                          "type": "boolean"
                        },
                        "selectedByteLength": {
                          "type": "string",
                          "maxLength": 22,
                          "pattern": "^(?:0|[1-9][0-9]{0,21})$(?![\\s\\S])"
                        },
                        "ranges": {
                          "minItems": 1,
                          "maxItems": 16,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "index": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 15
                              },
                              "specification": {
                                "type": "string",
                                "minLength": 2,
                                "maxLength": 41
                              },
                              "kind": {
                                "type": "string",
                                "enum": [
                                  "closed",
                                  "open",
                                  "suffix"
                                ]
                              },
                              "satisfiable": {
                                "type": "boolean"
                              },
                              "start": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 20,
                                    "pattern": "^(?:0|[1-9][0-9]{0,19})$(?![\\s\\S])"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "endExclusive": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "maxLength": 20,
                                    "pattern": "^(?:0|[1-9][0-9]{0,19})$(?![\\s\\S])"
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "byteLength": {
                                "type": "string",
                                "maxLength": 20,
                                "pattern": "^(?:0|[1-9][0-9]{0,19})$(?![\\s\\S])"
                              }
                            },
                            "required": [
                              "index",
                              "specification",
                              "kind",
                              "satisfiable",
                              "start",
                              "endExclusive",
                              "byteLength"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "representationLength",
                        "normalizedRange",
                        "satisfiable",
                        "selectedByteLength",
                        "ranges"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-byte-ranges-resolve",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-byte-ranges-exact-v1",
                    "representationLength": "10",
                    "normalizedRange": "bytes=0-1,8-,-0,99-100",
                    "satisfiable": true,
                    "selectedByteLength": "4",
                    "ranges": [
                      {
                        "index": 0,
                        "specification": "0-1",
                        "kind": "closed",
                        "satisfiable": true,
                        "start": "0",
                        "endExclusive": "2",
                        "byteLength": "2"
                      },
                      {
                        "index": 1,
                        "specification": "8-",
                        "kind": "open",
                        "satisfiable": true,
                        "start": "8",
                        "endExclusive": "10",
                        "byteLength": "2"
                      },
                      {
                        "index": 2,
                        "specification": "-0",
                        "kind": "suffix",
                        "satisfiable": false,
                        "start": null,
                        "endExclusive": null,
                        "byteLength": "0"
                      },
                      {
                        "index": 3,
                        "specification": "99-100",
                        "kind": "closed",
                        "satisfiable": false,
                        "start": null,
                        "endExclusive": null,
                        "byteLength": "0"
                      }
                    ]
                  },
                  "provenance": {
                    "inputSha256": "82e7d2cada8260a948becd07c4d498e34add6f83f86cd665f2a1156bfe00ed2e",
                    "outputSha256": "0862b20b64b805b5eb418053d5643ff71bfc383c4308eca9444a5df8a578f569",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.004",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/http-byte-ranges-compose": {
      "post": {
        "operationId": "mpp_http_byte_ranges_compose",
        "summary": "Compose HTTP byte-range bodies",
        "description": "Compose exact inert single-range or multipart/byteranges 206 bodies, or an empty 416 artifact, from supplied nonempty Base64 bytes and a strict Range field. Byte-preserving order, offsets, fields and SHA-256; no conditional-request checks or transmission.",
        "tags": [
          "protocol-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/http-byte-ranges-compose.md"
        },
        "x-agent-discovery": {
          "intents": [
            "compose multipart byteranges body",
            "build exact partial content response bytes",
            "serialize single range Content-Range payload"
          ],
          "whenToUse": [
            "Create bounded partial-content test artifacts from inline bytes without decoding or contacting a server"
          ],
          "whenNotToUse": [
            "No remote fetching, request transmission, filesystem access, caching, content decoding or authenticity verification",
            "No server policy, method, conditional request or If-Range enforcement; callers must check applicability separately",
            "Not a full HTTP parser: unsupported units, empty list members, inner whitespace and numbers over 20 digits are rejected by this bounded profile",
            "Empty representations, media-type parameters, automatic boundary generation or boundary tokens appearing anywhere in selected payloads"
          ],
          "capabilities": [
            "Resolves Range internally; no separately paid resolver call is required",
            "Exact canonical Base64 body and SHA-256 over binary bytes",
            "Single or multipart selection preserves all satisfiable occurrences without coalescing",
            "At most 8 supplied Range members; linear boundary-collision scanning and full sizing precede payment"
          ],
          "related": [
            "http-byte-ranges-resolve",
            "multipart-form-encode",
            "http-etag-evaluate"
          ],
          "limits": {
            "inputBytes": 16384,
            "outputBytes": 24576,
            "jsonNodes": 128,
            "depth": 4,
            "rangeBytes": 2048,
            "ranges": 8,
            "composeRanges": 8,
            "integerDigits": 20,
            "representationBytes": 8192,
            "bodyBytes": 8192,
            "mediaTypeBytes": 127,
            "boundaryBytes": 60,
            "profile": "http-byte-ranges-body-v1"
          },
          "errorCodes": [
            "INVALID_INPUT",
            "INVALID_UNICODE",
            "INVALID_RANGE",
            "INVALID_BASE64",
            "EMPTY_REPRESENTATION",
            "BOUNDARY_REQUIRED",
            "UNUSED_BOUNDARY",
            "BOUNDARY_COLLISION",
            "INPUT_LIMIT",
            "INTEGER_LIMIT",
            "RANGE_LIMIT",
            "COMPLEXITY_LIMIT",
            "OUTPUT_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "representationBase64": {
                    "type": "string",
                    "maxLength": 10924,
                    "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$(?![\\s\\S])"
                  },
                  "range": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2048,
                    "pattern": "^[\\x09\\x20-\\x7e]+$(?![\\s\\S])"
                  },
                  "mediaType": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 127,
                    "pattern": "^[!#$%&'*+.^_`|~0-9A-Za-z-]+\\/[!#$%&'*+.^_`|~0-9A-Za-z-]+$(?![\\s\\S])"
                  },
                  "boundary": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 60,
                    "pattern": "^[A-Za-z0-9_-]+$(?![\\s\\S])"
                  }
                },
                "required": [
                  "representationBase64",
                  "range",
                  "mediaType"
                ],
                "additionalProperties": false
              },
              "example": {
                "representationBase64": "MDEyMzQ1Njc4OQ==",
                "range": "bytes=0-1,-2",
                "mediaType": "application/octet-stream",
                "boundary": "asm-demo"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "http-byte-ranges-compose",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "http-byte-ranges-body-v1"
                        },
                        "representationByteLength": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 8192
                        },
                        "representationSha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$(?![\\s\\S])"
                        },
                        "normalizedRange": {
                          "type": "string",
                          "maxLength": 2048
                        },
                        "disposition": {
                          "type": "string",
                          "enum": [
                            "single",
                            "multipart",
                            "unsatisfiable"
                          ]
                        },
                        "statusCode": {
                          "anyOf": [
                            {
                              "type": "number",
                              "const": 206
                            },
                            {
                              "type": "number",
                              "const": 416
                            }
                          ]
                        },
                        "headers": {
                          "minItems": 2,
                          "maxItems": 3,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "enum": [
                                  "content-type",
                                  "content-range",
                                  "content-length"
                                ]
                              },
                              "value": {
                                "type": "string",
                                "maxLength": 256
                              }
                            },
                            "required": [
                              "name",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "bodyBase64": {
                          "type": "string",
                          "maxLength": 10924,
                          "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$(?![\\s\\S])"
                        },
                        "bodyByteLength": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 8192
                        },
                        "bodySha256": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$(?![\\s\\S])"
                        },
                        "parts": {
                          "maxItems": 8,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "rangeIndex": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 7
                              },
                              "sourceStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8192
                              },
                              "sourceEndExclusive": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8192
                              },
                              "contentRange": {
                                "type": "string",
                                "maxLength": 80
                              },
                              "headerStart": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 8192
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "bodyStart": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8192
                              },
                              "bodyEndExclusive": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 8192
                              }
                            },
                            "required": [
                              "rangeIndex",
                              "sourceStart",
                              "sourceEndExclusive",
                              "contentRange",
                              "headerStart",
                              "bodyStart",
                              "bodyEndExclusive"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "unsatisfiedIndexes": {
                          "maxItems": 8,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 7
                          }
                        }
                      },
                      "required": [
                        "profile",
                        "representationByteLength",
                        "representationSha256",
                        "normalizedRange",
                        "disposition",
                        "statusCode",
                        "headers",
                        "bodyBase64",
                        "bodyByteLength",
                        "bodySha256",
                        "parts",
                        "unsatisfiedIndexes"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "http-byte-ranges-compose",
                  "version": "0.29.0",
                  "result": {
                    "profile": "http-byte-ranges-body-v1",
                    "representationByteLength": 10,
                    "representationSha256": "84d89877f0d4041efb6bf91a16f0248f2fd573e6af05c19f96bedb9f882f7882",
                    "normalizedRange": "bytes=0-1,-2",
                    "disposition": "multipart",
                    "statusCode": 206,
                    "headers": [
                      {
                        "name": "content-type",
                        "value": "multipart/byteranges; boundary=asm-demo"
                      },
                      {
                        "name": "content-length",
                        "value": "188"
                      }
                    ],
                    "bodyBase64": "LS1hc20tZGVtbw0KQ29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9vY3RldC1zdHJlYW0NCkNvbnRlbnQtUmFuZ2U6IGJ5dGVzIDAtMS8xMA0KDQowMQ0KLS1hc20tZGVtbw0KQ29udGVudC1UeXBlOiBhcHBsaWNhdGlvbi9vY3RldC1zdHJlYW0NCkNvbnRlbnQtUmFuZ2U6IGJ5dGVzIDgtOS8xMA0KDQo4OQ0KLS1hc20tZGVtby0tDQo=",
                    "bodyByteLength": 188,
                    "bodySha256": "8c00af0e0d042f38edfe820ff6f399dcab6d90ad91374fd25e639051eda0086a",
                    "parts": [
                      {
                        "rangeIndex": 0,
                        "sourceStart": 0,
                        "sourceEndExclusive": 2,
                        "contentRange": "bytes 0-1/10",
                        "headerStart": 0,
                        "bodyStart": 83,
                        "bodyEndExclusive": 85
                      },
                      {
                        "rangeIndex": 1,
                        "sourceStart": 8,
                        "sourceEndExclusive": 10,
                        "contentRange": "bytes 8-9/10",
                        "headerStart": 87,
                        "bodyStart": 170,
                        "bodyEndExclusive": 172
                      }
                    ],
                    "unsatisfiedIndexes": []
                  },
                  "provenance": {
                    "inputSha256": "4f0beb8da86b883826c74719cf6ad2da918d9beb0b5d2fd192f42c8a0bf448f9",
                    "outputSha256": "f7d4001ede91f24739c26320a912ad4afa297647361157d6eb32f5e2e7075864",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/route-matrix-optimize": {
      "post": {
        "operationId": "mpp_route_matrix_optimize",
        "summary": "Exact supplied-matrix route",
        "description": "Find an exact minimum-cost directed route visiting every supplied stop once, as a fixed-start cycle or open path with optional fixed end. Null arcs are forbidden; no maps, geocoding, traffic, vehicle capacity, time windows or dispatch.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/route-matrix-optimize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Optimize a small directed travelling-salesperson tour from a supplied cost matrix",
            "Choose the least-cost order for visiting every supplied stop exactly once"
          ],
          "whenToUse": [
            "All leg costs and allowed arcs are supplied in one declared unit; at most 12 stops including the start"
          ],
          "whenNotToUse": [
            "Shortest paths that may skip/revisit stops, real routing data, multiple vehicles, capacity or time windows",
            "General route search beyond the exact bounded Hamiltonian model",
            "Investment advice, high-impact decisions about people, or validating the truth of caller assumptions"
          ],
          "capabilities": [
            "Exact decimal BigInt subset dynamic programming with lexical optimal ties",
            "Explicit cycle, free-end path or fixed-end path; valid infeasible results have no route",
            "A one-stop request produces its start only, no self-loop and exact zero cost",
            "Complete computation and result sizing before payment challenge",
            "Exact bounded supplied-data arithmetic; no network, clock, randomness or external action"
          ],
          "related": [
            "assignment-cost-optimize",
            "workflow-resource-plan"
          ],
          "limits": {
            "inputBytes": 48000,
            "outputBytes": 192000,
            "jsonNodes": 8000,
            "depth": 12,
            "stops": 12,
            "matrixCells": 144,
            "allocatedDpCells": 24576,
            "maximumTransitionChecks": 135168,
            "decimalIntegerDigits": 12,
            "decimalFractionDigits": 6
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "DUPLICATE_ID",
            "MATRIX_SHAPE",
            "UNKNOWN_STOP",
            "INVALID_ENDPOINTS",
            "INVALID_DIAGONAL",
            "INTERNAL_ROUTE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "stopIds": {
                    "minItems": 1,
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    }
                  },
                  "costs": {
                    "minItems": 1,
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 12,
                      "type": "array",
                      "items": {
                        "anyOf": [
                          {
                            "type": "string",
                            "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    }
                  },
                  "route": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "cycle"
                          },
                          "startId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          }
                        },
                        "required": [
                          "kind",
                          "startId"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "const": "path"
                          },
                          "startId": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          },
                          "endId": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        },
                        "required": [
                          "kind",
                          "startId",
                          "endId"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "costUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  }
                },
                "required": [
                  "stopIds",
                  "costs",
                  "route",
                  "costUnit"
                ],
                "additionalProperties": false
              },
              "example": {
                "stopIds": [
                  "depot",
                  "alpha",
                  "beta",
                  "gamma"
                ],
                "costs": [
                  [
                    "0",
                    "4",
                    "2",
                    "8"
                  ],
                  [
                    "3",
                    "0",
                    "5",
                    "2"
                  ],
                  [
                    "7",
                    "1",
                    "0",
                    "6"
                  ],
                  [
                    "3",
                    "4",
                    "2",
                    "0"
                  ]
                ],
                "route": {
                  "kind": "cycle",
                  "startId": "depot"
                },
                "costUnit": "declared travel minutes"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "route-matrix-optimize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "exact-directed-hamiltonian-route-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "assumptionsVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "costUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "stopIds": {
                              "minItems": 1,
                              "maxItems": 12,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              }
                            },
                            "route": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "cycle"
                                    },
                                    "startId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 64
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "startId"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "path"
                                    },
                                    "startId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 64
                                    },
                                    "endId": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 64
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "startId",
                                    "endId"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            "algorithm": {
                              "type": "string",
                              "const": "subset-dynamic-programming"
                            },
                            "work": {
                              "type": "object",
                              "properties": {
                                "statesEvaluated": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 24576
                                },
                                "transitionsConsidered": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 135168
                                }
                              },
                              "required": [
                                "statesEvaluated",
                                "transitionsConsidered"
                              ],
                              "additionalProperties": false
                            },
                            "status": {
                              "type": "string",
                              "const": "optimal"
                            },
                            "visitOrder": {
                              "minItems": 1,
                              "maxItems": 13,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              }
                            },
                            "legs": {
                              "maxItems": 12,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "fromId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 64
                                  },
                                  "toId": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 64
                                  },
                                  "cost": {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "pattern": "^(?:0|[1-9][0-9]*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "pattern": "^[1-9][0-9]*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  }
                                },
                                "required": [
                                  "fromId",
                                  "toId",
                                  "cost"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "totalCost": {
                              "type": "object",
                              "properties": {
                                "numerator": {
                                  "type": "string",
                                  "pattern": "^(?:0|[1-9][0-9]*)$"
                                },
                                "denominator": {
                                  "type": "string",
                                  "pattern": "^[1-9][0-9]*$"
                                }
                              },
                              "required": [
                                "numerator",
                                "denominator"
                              ],
                              "additionalProperties": false
                            },
                            "tieBreak": {
                              "type": "string",
                              "const": "lexicographically-smallest-visit-order-by-UTF-16"
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "assumptionsVerified",
                            "costUnit",
                            "stopIds",
                            "route",
                            "algorithm",
                            "work",
                            "status",
                            "visitOrder",
                            "legs",
                            "totalCost",
                            "tieBreak"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "profile": {
                              "type": "string",
                              "const": "exact-directed-hamiltonian-route-v1"
                            },
                            "externalRequests": {
                              "type": "number",
                              "const": 0
                            },
                            "execution": {
                              "type": "boolean",
                              "const": false
                            },
                            "assumptionsVerified": {
                              "type": "boolean",
                              "const": false
                            },
                            "costUnit": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 64
                            },
                            "stopIds": {
                              "minItems": 1,
                              "maxItems": 12,
                              "type": "array",
                              "items": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              }
                            },
                            "route": {
                              "oneOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "cycle"
                                    },
                                    "startId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 64
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "startId"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "object",
                                  "properties": {
                                    "kind": {
                                      "type": "string",
                                      "const": "path"
                                    },
                                    "startId": {
                                      "type": "string",
                                      "minLength": 1,
                                      "maxLength": 64
                                    },
                                    "endId": {
                                      "anyOf": [
                                        {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 64
                                        },
                                        {
                                          "type": "null"
                                        }
                                      ]
                                    }
                                  },
                                  "required": [
                                    "kind",
                                    "startId",
                                    "endId"
                                  ],
                                  "additionalProperties": false
                                }
                              ]
                            },
                            "algorithm": {
                              "type": "string",
                              "const": "subset-dynamic-programming"
                            },
                            "work": {
                              "type": "object",
                              "properties": {
                                "statesEvaluated": {
                                  "type": "integer",
                                  "minimum": 1,
                                  "maximum": 24576
                                },
                                "transitionsConsidered": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 135168
                                }
                              },
                              "required": [
                                "statesEvaluated",
                                "transitionsConsidered"
                              ],
                              "additionalProperties": false
                            },
                            "status": {
                              "type": "string",
                              "const": "infeasible"
                            },
                            "visitOrder": {
                              "type": "null"
                            },
                            "legs": {
                              "type": "null"
                            },
                            "totalCost": {
                              "type": "null"
                            },
                            "reason": {
                              "type": "string",
                              "const": "No route visits every supplied stop exactly once under the declared endpoints and allowed arcs"
                            }
                          },
                          "required": [
                            "profile",
                            "externalRequests",
                            "execution",
                            "assumptionsVerified",
                            "costUnit",
                            "stopIds",
                            "route",
                            "algorithm",
                            "work",
                            "status",
                            "visitOrder",
                            "legs",
                            "totalCost",
                            "reason"
                          ],
                          "additionalProperties": false
                        }
                      ]
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "route-matrix-optimize",
                  "version": "0.29.0",
                  "result": {
                    "profile": "exact-directed-hamiltonian-route-v1",
                    "externalRequests": 0,
                    "execution": false,
                    "assumptionsVerified": false,
                    "costUnit": "declared travel minutes",
                    "stopIds": [
                      "alpha",
                      "beta",
                      "depot",
                      "gamma"
                    ],
                    "route": {
                      "kind": "cycle",
                      "startId": "depot"
                    },
                    "algorithm": "subset-dynamic-programming",
                    "work": {
                      "statesEvaluated": 20,
                      "transitionsConsidered": 24
                    },
                    "status": "optimal",
                    "visitOrder": [
                      "depot",
                      "beta",
                      "alpha",
                      "gamma",
                      "depot"
                    ],
                    "legs": [
                      {
                        "fromId": "depot",
                        "toId": "beta",
                        "cost": {
                          "numerator": "2",
                          "denominator": "1"
                        }
                      },
                      {
                        "fromId": "beta",
                        "toId": "alpha",
                        "cost": {
                          "numerator": "1",
                          "denominator": "1"
                        }
                      },
                      {
                        "fromId": "alpha",
                        "toId": "gamma",
                        "cost": {
                          "numerator": "2",
                          "denominator": "1"
                        }
                      },
                      {
                        "fromId": "gamma",
                        "toId": "depot",
                        "cost": {
                          "numerator": "3",
                          "denominator": "1"
                        }
                      }
                    ],
                    "totalCost": {
                      "numerator": "8",
                      "denominator": "1"
                    },
                    "tieBreak": "lexicographically-smallest-visit-order-by-UTF-16"
                  },
                  "provenance": {
                    "inputSha256": "69efa70491b7b083786ef5f6071ee2963cb1eaaf0be6d0d27dec7bc05b2648d2",
                    "outputSha256": "49ae8abe2fd859ad0e439a60afe82b5b38520337afe6da77ca7d9d5e80942e9d",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.010",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/decision-scenarios-analyze": {
      "post": {
        "operationId": "mpp_decision_scenarios_analyze",
        "summary": "Exact finite-scenario decision tradeoffs",
        "description": "Compare caller-defined alternatives using a complete loss matrix: all expected-loss, worst-loss and minimax-regret optima, scenario Pareto dominance and perfect-information value. Optional explicit positive relative probabilities; no inferred likelihoods or universal recommendation.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/decision-scenarios-analyze.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Compare decision alternatives under supplied uncertain scenarios",
            "Compute exact minimax regret, worst-case loss and Pareto-dominated options",
            "Calculate expected-loss choices and perfect-information value from explicit scenario weights"
          ],
          "whenToUse": [
            "Caller supplies complete nonnegative losses in one unit for every alternative and scenario",
            "Use null probabilityWeights when no probability model is justified"
          ],
          "whenNotToUse": [
            "Forecasting, eliciting utilities or probabilities, validating scenario completeness, continuous or randomized policies",
            "Weighted rubric aggregation with missing observations or incompatible units",
            "Investment advice, high-impact decisions about people, or validating the truth of caller assumptions"
          ],
          "capabilities": [
            "All tied minimizers retained with exact decimal and rational arithmetic",
            "Strict Pareto dominance requires no worse loss everywhere and strictly lower loss somewhere; identical alternatives remain nondominated",
            "Expected values are absent unless strictly positive relative probability weights are supplied for every scenario",
            "Perfect-information value assumes cost-free advance revelation of the supplied scenario and is not the value of a real experiment",
            "Exact bounded supplied-data arithmetic; no network, clock, randomness or external action"
          ],
          "related": [
            "rubric-score-aggregate",
            "inventory-scenarios-optimize"
          ],
          "limits": {
            "inputBytes": 48000,
            "outputBytes": 192000,
            "jsonNodes": 8000,
            "depth": 12,
            "alternatives": 24,
            "scenarios": 24,
            "matrixCells": 576,
            "maximumDominanceCellComparisons": 27648,
            "decimalIntegerDigits": 12,
            "decimalFractionDigits": 6,
            "probabilityWeightDigits": 9
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "DUPLICATE_ID",
            "MATRIX_SHAPE",
            "WEIGHT_SHAPE"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "alternativeIds": {
                    "minItems": 1,
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    }
                  },
                  "scenarioIds": {
                    "minItems": 1,
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 64
                    }
                  },
                  "losses": {
                    "minItems": 1,
                    "maxItems": 24,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 24,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                      }
                    }
                  },
                  "probabilityWeights": {
                    "anyOf": [
                      {
                        "minItems": 1,
                        "maxItems": 24,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "pattern": "^[1-9][0-9]{0,8}$"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "lossUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  }
                },
                "required": [
                  "alternativeIds",
                  "scenarioIds",
                  "losses",
                  "probabilityWeights",
                  "lossUnit"
                ],
                "additionalProperties": false
              },
              "example": {
                "alternativeIds": [
                  "small-cache",
                  "balanced-cache",
                  "large-cache"
                ],
                "scenarioIds": [
                  "light-load",
                  "heavy-load"
                ],
                "losses": [
                  [
                    "2",
                    "12"
                  ],
                  [
                    "5",
                    "6"
                  ],
                  [
                    "9",
                    "3"
                  ]
                ],
                "probabilityWeights": [
                  "3",
                  "1"
                ],
                "lossUnit": "caller-defined operating loss units"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "decision-scenarios-analyze",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "finite-scenario-loss-analysis-v1"
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "assumptionsVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "lossUnit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "scenarioIds": {
                          "minItems": 1,
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          }
                        },
                        "probabilityModel": {
                          "type": "string",
                          "enum": [
                            "none-supplied",
                            "normalized-positive-relative-weights"
                          ]
                        },
                        "scenarios": {
                          "minItems": 1,
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "scenarioId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              "probability": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "pattern": "^(?:0|[1-9][0-9]*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "pattern": "^[1-9][0-9]*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "bestLoss": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "bestAlternativeIds": {
                                "minItems": 1,
                                "maxItems": 24,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                }
                              }
                            },
                            "required": [
                              "scenarioId",
                              "probability",
                              "bestLoss",
                              "bestAlternativeIds"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "alternatives": {
                          "minItems": 1,
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "alternativeId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              "expectedLoss": {
                                "anyOf": [
                                  {
                                    "type": "object",
                                    "properties": {
                                      "numerator": {
                                        "type": "string",
                                        "pattern": "^(?:0|[1-9][0-9]*)$"
                                      },
                                      "denominator": {
                                        "type": "string",
                                        "pattern": "^[1-9][0-9]*$"
                                      }
                                    },
                                    "required": [
                                      "numerator",
                                      "denominator"
                                    ],
                                    "additionalProperties": false
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "worstLoss": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "maximumRegret": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "regrets": {
                                "minItems": 1,
                                "maxItems": 24,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "numerator": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "denominator": {
                                      "type": "string",
                                      "pattern": "^[1-9][0-9]*$"
                                    }
                                  },
                                  "required": [
                                    "numerator",
                                    "denominator"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "dominatedBy": {
                                "maxItems": 23,
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 64
                                }
                              }
                            },
                            "required": [
                              "alternativeId",
                              "expectedLoss",
                              "worstLoss",
                              "maximumRegret",
                              "regrets",
                              "dominatedBy"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "criteria": {
                          "type": "object",
                          "properties": {
                            "expectedLoss": {
                              "anyOf": [
                                {
                                  "type": "object",
                                  "properties": {
                                    "minimum": {
                                      "type": "object",
                                      "properties": {
                                        "numerator": {
                                          "type": "string",
                                          "pattern": "^(?:0|[1-9][0-9]*)$"
                                        },
                                        "denominator": {
                                          "type": "string",
                                          "pattern": "^[1-9][0-9]*$"
                                        }
                                      },
                                      "required": [
                                        "numerator",
                                        "denominator"
                                      ],
                                      "additionalProperties": false
                                    },
                                    "alternativeIds": {
                                      "minItems": 1,
                                      "maxItems": 24,
                                      "type": "array",
                                      "items": {
                                        "type": "string",
                                        "minLength": 1,
                                        "maxLength": 64
                                      }
                                    }
                                  },
                                  "required": [
                                    "minimum",
                                    "alternativeIds"
                                  ],
                                  "additionalProperties": false
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "worstLoss": {
                              "type": "object",
                              "properties": {
                                "minimum": {
                                  "type": "object",
                                  "properties": {
                                    "numerator": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "denominator": {
                                      "type": "string",
                                      "pattern": "^[1-9][0-9]*$"
                                    }
                                  },
                                  "required": [
                                    "numerator",
                                    "denominator"
                                  ],
                                  "additionalProperties": false
                                },
                                "alternativeIds": {
                                  "minItems": 1,
                                  "maxItems": 24,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 64
                                  }
                                }
                              },
                              "required": [
                                "minimum",
                                "alternativeIds"
                              ],
                              "additionalProperties": false
                            },
                            "maximumRegret": {
                              "type": "object",
                              "properties": {
                                "minimum": {
                                  "type": "object",
                                  "properties": {
                                    "numerator": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "denominator": {
                                      "type": "string",
                                      "pattern": "^[1-9][0-9]*$"
                                    }
                                  },
                                  "required": [
                                    "numerator",
                                    "denominator"
                                  ],
                                  "additionalProperties": false
                                },
                                "alternativeIds": {
                                  "minItems": 1,
                                  "maxItems": 24,
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 64
                                  }
                                }
                              },
                              "required": [
                                "minimum",
                                "alternativeIds"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "expectedLoss",
                            "worstLoss",
                            "maximumRegret"
                          ],
                          "additionalProperties": false
                        },
                        "paretoAlternativeIds": {
                          "minItems": 1,
                          "maxItems": 24,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 64
                          }
                        },
                        "perfectInformation": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "expectedBestScenarioLoss": {
                                  "type": "object",
                                  "properties": {
                                    "numerator": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "denominator": {
                                      "type": "string",
                                      "pattern": "^[1-9][0-9]*$"
                                    }
                                  },
                                  "required": [
                                    "numerator",
                                    "denominator"
                                  ],
                                  "additionalProperties": false
                                },
                                "expectedValue": {
                                  "type": "object",
                                  "properties": {
                                    "numerator": {
                                      "type": "string",
                                      "pattern": "^(?:0|[1-9][0-9]*)$"
                                    },
                                    "denominator": {
                                      "type": "string",
                                      "pattern": "^[1-9][0-9]*$"
                                    }
                                  },
                                  "required": [
                                    "numerator",
                                    "denominator"
                                  ],
                                  "additionalProperties": false
                                }
                              },
                              "required": [
                                "expectedBestScenarioLoss",
                                "expectedValue"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "tiePolicy": {
                          "type": "string",
                          "const": "return-all-exact-ties-in-UTF-16-ID-order"
                        }
                      },
                      "required": [
                        "profile",
                        "externalRequests",
                        "execution",
                        "assumptionsVerified",
                        "lossUnit",
                        "scenarioIds",
                        "probabilityModel",
                        "scenarios",
                        "alternatives",
                        "criteria",
                        "paretoAlternativeIds",
                        "perfectInformation",
                        "tiePolicy"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "decision-scenarios-analyze",
                  "version": "0.29.0",
                  "result": {
                    "profile": "finite-scenario-loss-analysis-v1",
                    "externalRequests": 0,
                    "execution": false,
                    "assumptionsVerified": false,
                    "lossUnit": "caller-defined operating loss units",
                    "scenarioIds": [
                      "heavy-load",
                      "light-load"
                    ],
                    "probabilityModel": "normalized-positive-relative-weights",
                    "scenarios": [
                      {
                        "scenarioId": "heavy-load",
                        "probability": {
                          "numerator": "1",
                          "denominator": "4"
                        },
                        "bestLoss": {
                          "numerator": "3",
                          "denominator": "1"
                        },
                        "bestAlternativeIds": [
                          "large-cache"
                        ]
                      },
                      {
                        "scenarioId": "light-load",
                        "probability": {
                          "numerator": "3",
                          "denominator": "4"
                        },
                        "bestLoss": {
                          "numerator": "2",
                          "denominator": "1"
                        },
                        "bestAlternativeIds": [
                          "small-cache"
                        ]
                      }
                    ],
                    "alternatives": [
                      {
                        "alternativeId": "balanced-cache",
                        "expectedLoss": {
                          "numerator": "21",
                          "denominator": "4"
                        },
                        "worstLoss": {
                          "numerator": "6",
                          "denominator": "1"
                        },
                        "maximumRegret": {
                          "numerator": "3",
                          "denominator": "1"
                        },
                        "regrets": [
                          {
                            "numerator": "3",
                            "denominator": "1"
                          },
                          {
                            "numerator": "3",
                            "denominator": "1"
                          }
                        ],
                        "dominatedBy": []
                      },
                      {
                        "alternativeId": "large-cache",
                        "expectedLoss": {
                          "numerator": "15",
                          "denominator": "2"
                        },
                        "worstLoss": {
                          "numerator": "9",
                          "denominator": "1"
                        },
                        "maximumRegret": {
                          "numerator": "7",
                          "denominator": "1"
                        },
                        "regrets": [
                          {
                            "numerator": "0",
                            "denominator": "1"
                          },
                          {
                            "numerator": "7",
                            "denominator": "1"
                          }
                        ],
                        "dominatedBy": []
                      },
                      {
                        "alternativeId": "small-cache",
                        "expectedLoss": {
                          "numerator": "9",
                          "denominator": "2"
                        },
                        "worstLoss": {
                          "numerator": "12",
                          "denominator": "1"
                        },
                        "maximumRegret": {
                          "numerator": "9",
                          "denominator": "1"
                        },
                        "regrets": [
                          {
                            "numerator": "9",
                            "denominator": "1"
                          },
                          {
                            "numerator": "0",
                            "denominator": "1"
                          }
                        ],
                        "dominatedBy": []
                      }
                    ],
                    "criteria": {
                      "expectedLoss": {
                        "minimum": {
                          "numerator": "9",
                          "denominator": "2"
                        },
                        "alternativeIds": [
                          "small-cache"
                        ]
                      },
                      "worstLoss": {
                        "minimum": {
                          "numerator": "6",
                          "denominator": "1"
                        },
                        "alternativeIds": [
                          "balanced-cache"
                        ]
                      },
                      "maximumRegret": {
                        "minimum": {
                          "numerator": "3",
                          "denominator": "1"
                        },
                        "alternativeIds": [
                          "balanced-cache"
                        ]
                      }
                    },
                    "paretoAlternativeIds": [
                      "balanced-cache",
                      "large-cache",
                      "small-cache"
                    ],
                    "perfectInformation": {
                      "expectedBestScenarioLoss": {
                        "numerator": "9",
                        "denominator": "4"
                      },
                      "expectedValue": {
                        "numerator": "9",
                        "denominator": "4"
                      }
                    },
                    "tiePolicy": "return-all-exact-ties-in-UTF-16-ID-order"
                  },
                  "provenance": {
                    "inputSha256": "6503438bf50595b06913f93b1bcf8848af7f8a5603bdaba4569da2df1f5e00e1",
                    "outputSha256": "7da7e3fd918490552b1a161ace8b7bc4f28243452db8962ae66114ab202853cb",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.006",
        "x-payment-status": "runtime-not-evaluated"
      }
    },
    "/v1/mpp/inventory-scenarios-optimize": {
      "post": {
        "operationId": "mpp_inventory_scenarios_optimize",
        "summary": "Exact finite-scenario inventory order",
        "description": "Enumerate every admissible one-period order quantity and minimize exact expected purchase, fixed-order, leftover and unmet-demand costs under caller-supplied demand scenarios. Return all optimal quantities and scenario arithmetic; no demand forecast, service guarantee or order placement.",
        "tags": [
          "workflow-assurance"
        ],
        "externalDocs": {
          "url": "https://replace-before-publishing.invalid/tools/inventory-scenarios-optimize.md"
        },
        "x-agent-discovery": {
          "intents": [
            "Optimize a single-period reorder quantity under explicit demand scenarios",
            "Compare order multiples and minimum-positive-order constraints with holding and shortage costs"
          ],
          "whenToUse": [
            "Supply integer inventory and demand in one unit, positive relative scenario probabilities and nonnegative cost assumptions",
            "All replenishment arrives before demand and every positive order follows the declared multiple and minimum"
          ],
          "whenNotToUse": [
            "Forecasting, multi-period inventory, uncertain lead time, backorder carryover, shelf life, multiple products or capacity coupling",
            "Real procurement, inventory availability checks, service-level promises or profit optimization",
            "Investment advice, high-impact decisions about people, or validating the truth of caller assumptions"
          ],
          "capabilities": [
            "Exact exhaustive expected-cost optimum across at most 512 legal quantities; zero order is always permitted",
            "Complete candidate expected/worst cost table, all exact ties, and smallest-quantity tie break",
            "Chosen-scenario shortage, leftover and normalized probabilities; existing on-hand purchase cost is sunk and excluded",
            "Stockout probability applies only to the supplied finite scenario model and is not a calibrated real-world risk estimate",
            "Exact bounded supplied-data arithmetic; no network, clock, randomness or external action"
          ],
          "related": [
            "decision-scenarios-analyze",
            "decimal-distribution-summarize"
          ],
          "limits": {
            "inputBytes": 48000,
            "outputBytes": 192000,
            "jsonNodes": 8000,
            "depth": 12,
            "scenarios": 32,
            "orderCandidates": 512,
            "maximumCandidateScenarioEvaluations": 16384,
            "maximumChosenScenarioEvaluations": 32,
            "quantityMaximum": 1000000,
            "decimalIntegerDigits": 12,
            "decimalFractionDigits": 6,
            "probabilityWeightDigits": 9
          },
          "errorCodes": [
            "INPUT_LIMIT",
            "OUTPUT_LIMIT",
            "COMPLEXITY_LIMIT",
            "INVALID_JSON",
            "INVALID_NUMBER",
            "INVALID_UNICODE",
            "UNSAFE_KEY",
            "INVALID_INPUT",
            "DUPLICATE_ID",
            "CANDIDATE_LIMIT"
          ]
        },
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{16,128}$"
            },
            "description": "New random key per operation. Reuse exactly for retries, with identical payload and payment credential."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "onHand": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "scenarios": {
                    "minItems": 1,
                    "maxItems": 32,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "demand": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000
                        },
                        "probabilityWeight": {
                          "type": "string",
                          "pattern": "^[1-9][0-9]{0,8}$"
                        }
                      },
                      "required": [
                        "id",
                        "demand",
                        "probabilityWeight"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "order": {
                    "type": "object",
                    "properties": {
                      "minimumPositive": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      },
                      "maximum": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1000000
                      },
                      "multiple": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      }
                    },
                    "required": [
                      "minimumPositive",
                      "maximum",
                      "multiple"
                    ],
                    "additionalProperties": false
                  },
                  "costs": {
                    "type": "object",
                    "properties": {
                      "purchasePerUnit": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                      },
                      "holdingPerUnit": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                      },
                      "shortagePerUnit": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                      },
                      "fixedPositiveOrder": {
                        "type": "string",
                        "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$"
                      }
                    },
                    "required": [
                      "purchasePerUnit",
                      "holdingPerUnit",
                      "shortagePerUnit",
                      "fixedPositiveOrder"
                    ],
                    "additionalProperties": false
                  },
                  "quantityUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  },
                  "costUnit": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64
                  }
                },
                "required": [
                  "onHand",
                  "scenarios",
                  "order",
                  "costs",
                  "quantityUnit",
                  "costUnit"
                ],
                "additionalProperties": false
              },
              "example": {
                "onHand": 3,
                "scenarios": [
                  {
                    "id": "low",
                    "demand": 4,
                    "probabilityWeight": "1"
                  },
                  {
                    "id": "normal",
                    "demand": 8,
                    "probabilityWeight": "2"
                  },
                  {
                    "id": "high",
                    "demand": 12,
                    "probabilityWeight": "1"
                  }
                ],
                "order": {
                  "minimumPositive": 4,
                  "maximum": 12,
                  "multiple": 2
                },
                "costs": {
                  "purchasePerUnit": "2",
                  "holdingPerUnit": "1",
                  "shortagePerUnit": "7",
                  "fixedPositiveOrder": "3"
                },
                "quantityUnit": "units",
                "costUnit": "caller-defined cost units"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid typed result or authenticated replay; live DNS replays preserve the original observation snapshot",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "operation",
                    "version",
                    "result",
                    "provenance"
                  ],
                  "properties": {
                    "operation": {
                      "const": "inventory-scenarios-optimize",
                      "type": "string"
                    },
                    "version": {
                      "const": "0.29.0",
                      "type": "string"
                    },
                    "result": {
                      "$schema": "https://json-schema.org/draft/2020-12/schema",
                      "type": "object",
                      "properties": {
                        "profile": {
                          "type": "string",
                          "const": "finite-scenario-single-period-inventory-v1"
                        },
                        "externalRequests": {
                          "type": "number",
                          "const": 0
                        },
                        "execution": {
                          "type": "boolean",
                          "const": false
                        },
                        "assumptionsVerified": {
                          "type": "boolean",
                          "const": false
                        },
                        "status": {
                          "type": "string",
                          "const": "optimal"
                        },
                        "quantityUnit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "costUnit": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 64
                        },
                        "orderQuantity": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 1000000
                        },
                        "availableQuantity": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 2000000
                        },
                        "expectedCost": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "pattern": "^[1-9][0-9]*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "worstCost": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "pattern": "^[1-9][0-9]*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "expectedShortage": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "pattern": "^[1-9][0-9]*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "expectedLeftover": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "pattern": "^[1-9][0-9]*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "suppliedScenarioStockoutProbability": {
                          "type": "object",
                          "properties": {
                            "numerator": {
                              "type": "string",
                              "pattern": "^(?:0|[1-9][0-9]*)$"
                            },
                            "denominator": {
                              "type": "string",
                              "pattern": "^[1-9][0-9]*$"
                            }
                          },
                          "required": [
                            "numerator",
                            "denominator"
                          ],
                          "additionalProperties": false
                        },
                        "optimalOrderQuantities": {
                          "minItems": 1,
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 1000000
                          }
                        },
                        "candidates": {
                          "minItems": 1,
                          "maxItems": 512,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "orderQuantity": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              },
                              "expectedCost": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "worstCost": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "orderQuantity",
                              "expectedCost",
                              "worstCost"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "chosenScenarios": {
                          "minItems": 1,
                          "maxItems": 32,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "scenarioId": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              "probability": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              },
                              "demand": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              },
                              "shortage": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 1000000
                              },
                              "leftover": {
                                "type": "integer",
                                "minimum": 0,
                                "maximum": 2000000
                              },
                              "cost": {
                                "type": "object",
                                "properties": {
                                  "numerator": {
                                    "type": "string",
                                    "pattern": "^(?:0|[1-9][0-9]*)$"
                                  },
                                  "denominator": {
                                    "type": "string",
                                    "pattern": "^[1-9][0-9]*$"
                                  }
                                },
                                "required": [
                                  "numerator",
                                  "denominator"
                                ],
                                "additionalProperties": false
                              }
                            },
                            "required": [
                              "scenarioId",
                              "probability",
                              "demand",
                              "shortage",
                              "leftover",
                              "cost"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "model": {
                          "type": "object",
                          "properties": {
                            "period": {
                              "type": "string",
                              "const": "single-period"
                            },
                            "replenishment": {
                              "type": "string",
                              "const": "all-ordered-units-before-demand"
                            },
                            "unmetDemand": {
                              "type": "string",
                              "const": "penalized-without-carryover"
                            },
                            "demandSource": {
                              "type": "string",
                              "const": "caller-supplied-finite-scenarios"
                            },
                            "probabilityModel": {
                              "type": "string",
                              "const": "normalized-positive-relative-weights"
                            }
                          },
                          "required": [
                            "period",
                            "replenishment",
                            "unmetDemand",
                            "demandSource",
                            "probabilityModel"
                          ],
                          "additionalProperties": false
                        },
                        "tieBreak": {
                          "type": "string",
                          "const": "smallest-order-quantity; all-optimal-quantities-also-returned"
                        }
                      },
                      "required": [
                        "profile",
                        "externalRequests",
                        "execution",
                        "assumptionsVerified",
                        "status",
                        "quantityUnit",
                        "costUnit",
                        "orderQuantity",
                        "availableQuantity",
                        "expectedCost",
                        "worstCost",
                        "expectedShortage",
                        "expectedLeftover",
                        "suppliedScenarioStockoutProbability",
                        "optimalOrderQuantities",
                        "candidates",
                        "chosenScenarios",
                        "model",
                        "tieBreak"
                      ],
                      "additionalProperties": false
                    },
                    "provenance": {
                      "type": "object",
                      "required": [
                        "inputSha256",
                        "outputSha256",
                        "deterministic",
                        "externalRequests"
                      ],
                      "properties": {
                        "inputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "outputSha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "deterministic": {
                          "const": true
                        },
                        "externalRequests": {
                          "const": 0
                        }
                      }
                    }
                  },
                  "additionalProperties": false
                },
                "example": {
                  "operation": "inventory-scenarios-optimize",
                  "version": "0.29.0",
                  "result": {
                    "profile": "finite-scenario-single-period-inventory-v1",
                    "externalRequests": 0,
                    "execution": false,
                    "assumptionsVerified": false,
                    "status": "optimal",
                    "quantityUnit": "units",
                    "costUnit": "caller-defined cost units",
                    "orderQuantity": 6,
                    "availableQuantity": 9,
                    "expectedCost": {
                      "numerator": "22",
                      "denominator": "1"
                    },
                    "worstCost": {
                      "numerator": "36",
                      "denominator": "1"
                    },
                    "expectedShortage": {
                      "numerator": "3",
                      "denominator": "4"
                    },
                    "expectedLeftover": {
                      "numerator": "7",
                      "denominator": "4"
                    },
                    "suppliedScenarioStockoutProbability": {
                      "numerator": "1",
                      "denominator": "4"
                    },
                    "optimalOrderQuantities": [
                      6
                    ],
                    "candidates": [
                      {
                        "orderQuantity": 0,
                        "expectedCost": {
                          "numerator": "35",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "63",
                          "denominator": "1"
                        }
                      },
                      {
                        "orderQuantity": 4,
                        "expectedCost": {
                          "numerator": "24",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "46",
                          "denominator": "1"
                        }
                      },
                      {
                        "orderQuantity": 6,
                        "expectedCost": {
                          "numerator": "22",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "36",
                          "denominator": "1"
                        }
                      },
                      {
                        "orderQuantity": 8,
                        "expectedCost": {
                          "numerator": "24",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "26",
                          "denominator": "1"
                        }
                      },
                      {
                        "orderQuantity": 10,
                        "expectedCost": {
                          "numerator": "28",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "32",
                          "denominator": "1"
                        }
                      },
                      {
                        "orderQuantity": 12,
                        "expectedCost": {
                          "numerator": "34",
                          "denominator": "1"
                        },
                        "worstCost": {
                          "numerator": "38",
                          "denominator": "1"
                        }
                      }
                    ],
                    "chosenScenarios": [
                      {
                        "scenarioId": "high",
                        "probability": {
                          "numerator": "1",
                          "denominator": "4"
                        },
                        "demand": 12,
                        "shortage": 3,
                        "leftover": 0,
                        "cost": {
                          "numerator": "36",
                          "denominator": "1"
                        }
                      },
                      {
                        "scenarioId": "low",
                        "probability": {
                          "numerator": "1",
                          "denominator": "4"
                        },
                        "demand": 4,
                        "shortage": 0,
                        "leftover": 5,
                        "cost": {
                          "numerator": "20",
                          "denominator": "1"
                        }
                      },
                      {
                        "scenarioId": "normal",
                        "probability": {
                          "numerator": "1",
                          "denominator": "2"
                        },
                        "demand": 8,
                        "shortage": 0,
                        "leftover": 1,
                        "cost": {
                          "numerator": "16",
                          "denominator": "1"
                        }
                      }
                    ],
                    "model": {
                      "period": "single-period",
                      "replenishment": "all-ordered-units-before-demand",
                      "unmetDemand": "penalized-without-carryover",
                      "demandSource": "caller-supplied-finite-scenarios",
                      "probabilityModel": "normalized-positive-relative-weights"
                    },
                    "tieBreak": "smallest-order-quantity; all-optimal-quantities-also-returned"
                  },
                  "provenance": {
                    "inputSha256": "e9bd47771b7ab5ca743bc425d2ff7a74a1233428d38fead34e0639f779c794c2",
                    "outputSha256": "11a18148d92b8f02fda0cf2acaf2441beb31688c28e80deaeceba054958ad0a5",
                    "deterministic": true,
                    "externalRequests": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Malformed request or missing/invalid idempotency key"
          },
          "402": {
            "description": "Payment required or rejected. Use SDK challenge headers; never send a new payment after an uncertain settlement."
          },
          "409": {
            "description": "Idempotency conflict, duplicate proof, or payment processing/uncertain"
          },
          "413": {
            "description": "Input or output exceeds bounded limits"
          },
          "415": {
            "description": "Expected application/json with no content encoding"
          },
          "422": {
            "description": "Operation input or semantic validation failed; no payment attempted"
          },
          "429": {
            "description": "Per-IP request or payment-attempt rate exceeded"
          },
          "503": {
            "description": "Merchant unconfigured, DNS provider-terms review missing, payment provider or durable state unavailable"
          }
        },
        "x-price-usd": "0.008",
        "x-payment-status": "runtime-not-evaluated"
      }
    }
  },
  "x-service-info": {
    "categories": [
      "data-transformation",
      "developer-tools",
      "document-processing"
    ],
    "docs": {
      "apiReference": "/openapi.json",
      "llms": "/llms.txt"
    }
  },
  "x-limits": {
    "requestBytes": 131072,
    "responseBytes": 524288,
    "jsonDepth": 32,
    "jsonNodes": 20000,
    "requestsPerMinute": 60,
    "paidAttemptsPerMinute": 20,
    "idempotencyHours": 24
  },
  "servers": [
    {
      "url": "https://api-not-configured.invalid",
      "description": "Non-routable placeholder: no API origin selected"
    }
  ],
  "x-release-snapshot": {
    "format": "static-release-reference-v1",
    "sourceVersion": "0.29.0",
    "sourceRegistrySha256": "a2b5ec09bf6c38b9d2879d746a4fded374f5928b445377b0270ef6aa8e6cac65",
    "generatedAt": "2026-10-06T15:38:00Z",
    "releaseAcceptance": "not-verified-by-generator",
    "runtimeReadiness": "not-evaluated",
    "livePaymentsVerified": false,
    "indexingVerified": false,
    "apiOrigin": null,
    "notice": "Build-time release reference. Runtime readiness, deployment, payment settlement and external indexing are not evaluated here. Prices are proposed; this file cannot authorize execution or payment."
  }
}